openapi: 3.1.0
info:
  title: BJS NIBRS National Estimates Property Crime Victimization API
  version: '1.0'
  description: Minimal OpenAPI 3.1 description of the Bureau of Justice Statistics' NIBRS National Estimates API. Datasets are served as Socrata-style resources with JSON or CSV representations selected by file extension.
  x-generated-from: https://bjs.ojp.gov/national-incident-based-reporting-system-nibrs-national-estimates-api
  x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://api.ojp.gov/bjsdataset/v1
  description: Production
tags:
- name: Victimization
paths:
  /resource/ms42-n765.json:
    get:
      tags:
      - Victimization
      summary: Victimization counts and percentages across demographics
      operationId: getVictimizationCounts
      parameters:
      - $ref: '#/components/parameters/LimitParam'
      - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RowList'
  /resource/uy37-xgmh.json:
    get:
      tags:
      - Victimization
      summary: Victimization rates by demographic characteristics
      operationId: getVictimizationRates
      parameters:
      - $ref: '#/components/parameters/LimitParam'
      - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RowList'
components:
  schemas:
    Row:
      type: object
      additionalProperties: true
    RowList:
      type: array
      items:
        $ref: '#/components/schemas/Row'
  parameters:
    LimitParam:
      name: $limit
      in: query
      description: Maximum number of records to return (default 1000).
      schema:
        type: integer
        minimum: 1
    OffsetParam:
      name: $offset
      in: query
      description: Pagination offset.
      schema:
        type: integer
        minimum: 0