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

All data calls are formed by adding the paths listed below to the following base URL: http://www.bjs.gov:8080.

For calls that provide data in multiple formats (i.e., XML, JSON, or CSV), the desired file format is specified by appending a format string (e.g., ?format=json ) to the end of the URL.

Using the second path listed below as an example, you would obtain the personal victimization data for 2010 in JSON format via the following URL: http://www.bjs.gov:8080/bjs/ncvs/v2/personal/2010?format=json

If a format is not specified, XML is provided by default.



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