Note!
In July of 2025, changes were made to specific endpoints. All datasets remain available using modified endpoint locations described in the access instructions below.
This page provides information on National Crime Victimization (NCVS) datasets by using the Application Programming Interface (API), which uses the Representational State Transfer architecture, which is commonly referred to as Rest APIs.
National Crime Victimization Survey (NCVS)
The National Crime Victimization Survey (NCVS) collects information on nonfatal personal crimes (i.e., rape or sexual assault, robbery, aggravated and simple assault, and personal larceny) and household property crimes (i.e., burglary/trespassing, motor vehicle theft, and other types of theft) both reported and not reported to the police. Survey respondents provide information about themselves (e.g., age, sex, race and Hispanic origin, marital status, education level, and income) and whether they experienced a victimization.
BJS created NCVS Select datasets, which are available through API and include commonly used variables for analysis. Complete versions of annual and concatenated NCVS data can be found at the National Archive of Criminal Justice Data.
NCVS Select Person level data
NCVS Select – Personal Population contains demographic information of respondents. All respondents, regardless of whether they reported a personal crime victimization, are included in this file.
NCVS Select – Personal Victimization contains personal crime victimizations. Personal crimes include rape and sexual assault, robbery, aggravated and simple assault, and personal theft/larceny (purse-snatching/pocket picking). Persons that did not report a personal crime victimization are not included on this file. Victimizations that took place outside of the United States are excluded from this file.
NCVS Select Person Level Codebook: provides description of person-level datasets.
NCVS Select Household level data
NCVS Select – Household Population contains demographic information of participating households. All respondents, regardless of whether they reported a household property crime victimization, are included in this file.
NCVS Select – Household Property Victimization contains property crime victimizations. Property crimes include burglary, theft, motor vehicle theft, and vandalism. Households that did not report a property crime victimization are not included on this file. Victimizations that took place outside of the United States are excluded from this file.
NCVS Select Household Level Codebook: provides description of household-level datasets.
The National Crime Victimization Survey (NCVS) uses a Rest API structure that is based on three broad components which are (1) Path; (2) Resource; and (3) Query Parameter. These 3 parts of accessing NCVS datasets can be defined as follows:
(a) Path – the location of BJS datasets.
(b) Resource – the specific dataset a user is trying to query (i.e. the NCVS Select Personal Victimization dataset).
(c) Filter Parameter – an optional parameter restricting the data returned to the number of rows or years.
Using the Rest API of https://api.ojp.gov/bjsdataset/v1/uy37-xgmh.csv?$limit=200000 as an example, the 3 components of the endpoint can be defined as follows:
- Path = https://api.ojp.gov/bjsdataset/v1/
- Resource = uy37-xgmh.csv
- Filter Parameter = ?$limit=200000
Note!
By default the NCVS API returns a maximum of 1,000 records. All NCVS datasets include more than 1,000 records for any given year. To receive a complete set of records from an NCVS API query, add a "Limit" parameter to the API call to increase the maximum number of records the query's allowed to return. See example queries and record counts under NCVS API endpoints queries below.
The NCVS API can return data to users in multiple formats including JSON and CSV formats. To specify a desired format, append a format string (.json, for example) to the end of the URL.
NCVS API endpoints
- NCVS Select Personal Victimization
Endpoint:
https://api.ojp.gov/bjsdataset/v1/gcuy-rt5g.json
https://api.ojp.gov/bjsdataset/v1/gcuy-rt5g.csv
Record counts: Number of NCVS Personal Victimization cases
- NCVS Select Personal Population
Endpoint:
https://api.ojp.gov/bjsdataset/v1/r4j4-fdwx.json
https://api.ojp.gov/bjsdataset/v1/r4j4-fdwx.csv
Record counts: Number of NCVS Personal Population cases
- NCVS Select Household Victimization
Endpoint:
https://api.ojp.gov/bjsdataset/v1/gkck-euys.json
https://api.ojp.gov/bjsdataset/v1/gkck-euys.csv
Record counts: Number of NCVS Household Victimization cases
- NCVS Select Household Population
Endpoint:
https://api.ojp.gov/bjsdataset/v1/ya4e-n9zp.json
https://api.ojp.gov/bjsdataset/v1/ya4e-n9zp.csv
Record counts: Number of NCVS Household Population cases
Example queries
Users may request either personal or household property victimization and population data for any years included in the datasets.
You can query and filter datasets using field names as parameters and the content you want to filter for as their values. Multiple filters may be combined using a boolean AND.
- To query the personal victimization data for all available years in CSV format: https://api.ojp.gov/bjsdataset/v1/uy37-xgmh.csv?$limit=200000
- To query the personal population data for 2010 and 2020 in JSON format: https://data.ojp.usdoj.gov/resource/r4j4-fdwx.json?$query=select * where year in ("2010", "2020") limit 500000
- To query the household property victimization data for 2020 in CSV format: https://api.ojp.gov/bjsdataset/v1/gkck-euys.csv?year=2020&$limit=12000