BJS: Bureau of Justice Statistics

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

Developer home
API Terms of Service

National Crime Victimization Survey (NCVS) API

The NCVS RESTful API is a web service that provides criminal victimization data obtained annually from a nationally representative sample of about 79,800 households and 143,210 persons interviewed each year. NCVS data describe the frequency, characteristics and consequences of criminal victimization in the United States. The NCVS provides the largest national forum for victims to describe the impact of crime and characteristics of violent offenders. It is one of two primary data collections about crime in the United States and is the only source of data about crimes not reported to the police.

The NCVS Victimization Analysis Tool (NVAT) allows users to examine data on violent victimization (rape/sexual assault, robbery, and aggravated and simple assault), property victimization (household burglary, theft, and motor vehicle theft), and personal theft (pocket picking and completed and attempted purse snatching). Users can analyze victimization counts, rates, and percents by certain victim and household characteristics, weapon use, victim-offender relationship, and crimes reported and not reported to police.

API Access

Click on the 'API endpoints' link below to obtain instructions on using the API and the types of calls that can be made. End-points are available in XML, JSON, and CSV formats. To see descriptions of the dataset variables, click on the "personal" and "household" links in the table below.

API endpoints

Data downloads and variable descriptions

The table below provides dataset variable descriptions and archives of the personal and household victimization datasets in CSV format. Due to the large size of the datasets, calls to the API require specification of a single year. The CSV archives shown below contain data for all the years specified.

Dataset Data archives in .CSV format Variable descriptions

Personal Victimization

Personal victimization includes all violent victimization, rape and sexual assault, robbery, aggravated assault, simple assault, and personal theft.
1993-2013 | 2003-2013 | 2008-2013 Personal

Household Victimization

Household victimization includes all property victimization, household burglary, motor vehicle theft, and theft.
1993-2013 | 2003-2013 | 2008-2013 Household


Methodology for the NCVS datasets

For codebooks and further details about the NCVS collection, visit the NCVS page at the National Archive of Criminal Justice Data (NACJD).

Back to Top