openapi: 3.1.0
info:
  title: BJS NIBRS National Estimates 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: Violent Crime
  - name: Property Crime
  - name: Victimization
paths:
  /resource/r32q-bdaw.json:
    get:
      tags: [Violent Crime]
      summary: Violent crime incidents (counts, percentages, rates)
      operationId: getViolentIncidents
      parameters:
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema: { $ref: '#/components/schemas/RowList' }
  /resource/iv7i-eah6.json:
    get:
      tags: [Property Crime]
      summary: Property crime incidents (counts, percentages, rates)
      operationId: getPropertyIncidents
      parameters:
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema: { $ref: '#/components/schemas/RowList' }
  /resource/x3sz-eb6y.json:
    get:
      tags: [Violent Crime]
      summary: Violent crime offenses (counts, percentages, rates)
      operationId: getViolentOffenses
      parameters:
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema: { $ref: '#/components/schemas/RowList' }
  /resource/kj7p-vx4s.json:
    get:
      tags: [Property Crime]
      summary: Property crime offenses (counts, percentages, rates)
      operationId: getPropertyOffenses
      parameters:
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/OffsetParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema: { $ref: '#/components/schemas/RowList' }
  /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:
  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
  schemas:
    Row:
      type: object
      additionalProperties: true
    RowList:
      type: array
      items:
        $ref: '#/components/schemas/Row'