BJS: Bureau of Justice Statistics

clear image
Home  |  About Us  |  Contact Us  |  Help  |  A-Z Topic List
 
 
Bureau of Justice Statistics (BJS)
Home  |  NCVS API  |  NCVS API endpoints

Developer home
NCVS API
API terms of service

NCVS API endpoints

Notice: The domain for the NCVS API endpoint has changed to https://api.bjs.ojp.gov. NCVS API users are encouraged to switch to the new endpoint as soon as possible in order to avoid any interruption of service.

All calls to the NCVS API are formed by adding the paths listed below to the following base URL: https://api.bjs.ojp.gov.

Users may request either personal or household victimization data for any year from 1993 through 2016. For example, the URL https://api.bjs.ojp.gov/bjs/ncvs/v2/personal/2010 returns personal victimization data for the year 2010. At present, the NCVS API does not support requests for multiple years of victimization data in a single call.

The NCVS API can return data to users in XML, CSV or JSON formats. To specify a desired format, append a format string (?format=json, for example) to the end of the URL. XML is the default, if no other format is specified.

Example:
Using the second path listed below as an example, a user would obtain the personal victimization data for 2010 in JSON format via the following URL: https://api.bjs.ojp.gov/bjs/ncvs/v2/personal/2010?format=json



top

/bjs/ncvs/v2

Returns a list of available NCVS datasets and their data types.

Method: GET




top

/bjs/ncvs/v2/personal/{year}

Returns the personal victimization counts of incidents reported to the NCVS by year.

Method: GET

Name Description Values
Format Format of the data provided. xml (default)
json
csv
Year Year will limit the data to only values that occurred the given year. 1993-2016



top

/bjs/ncvs/v2/personal/population/{year}

Returns the personal victimization population of incidents reported to the NCVS by year.

Method: GET

Name Description Values
Format Format of the data provided. xml (default)
json
csv
Year Year will limit the data to only values that occurred the given year. 1993-2016



top

/bjs/ncvs/v2/personal/fields/

Returns a description of the fields or columns used in the personal victimization datasets.

Method: GET




top

/bjs/ncvs/v2/household/{year}

Returns the household victimization counts of incidents reported to the NCVS by year.

Method: GET

Name Description Values
Format Format of the data provided. xml (default)
json
csv
Year Year will limit the data to only values that occurred the given year. 1993-2016



top

/bjs/ncvs/v2/household/population/{year}

Returns the household victimization population of incidents reported to the NCVS by year.

Method: GET

Name Description Values
Format Format of the data provided. xml (default)
json
csv
Year Year will limit the data to only values that occurred the given year. 1993-2016



top

/bjs/ncvs/v2/household/fields/

Returns a description of the fields or columns used in the household victimization datasets.

Method: GET




Back to Top