Federal Bureau of Investigation List API

openapi: 3.1.0
info:
  title: FBI Most Wanted List API
  description: The FBI Most Wanted API is designed to help developers easily get information on the FBI Wanted program, including Ten Most Wanted Fugitives, Most Wanted Terrorists, kidnappings and missing persons, and seeking information cases.
  version: 1.0.0
servers:
- url: https://api.fbi.gov/wanted/v1
tags:
- name: List
paths:
  /list:
    get:
      summary: Federal Bureau of Investigation Retrieve list of FBI wanted individuals
      description: Fetches a list of FBI wanted individuals, with optional filters for field offices and paging.
      parameters:
      - name: field_offices
        in: query
        required: false
        description: Filter by specific FBI field offices (e.g., miami, new-york, los-angeles).
        schema:
          type: string
      - name: page
        in: query
        required: false
        description: Specifies the page of results to return (used for pagination).
        schema:
          type: integer
      - name: sort_on
        in: query
        required: false
        description: Specifies the field to sort results by (e.g., title, reward, etc.).
        schema:
          type: string
      - name: sort_order
        in: query
        required: false
        description: Specifies the order of the sorting (asc or desc).
        schema:
          type: string
          enum:
          - asc
          - desc
      responses:
        '200':
          description: Successful response containing the list of FBI wanted individuals.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FBIWantedResponse'
        '400':
          description: Invalid query parameters or bad request.
        '404':
          description: No results found for the given query parameters.
        '500':
          description: Internal server error.
      tags:
      - List
components:
  schemas:
    FBIWantedResponse:
      type: object
      properties:
        total:
          type: integer
          description: Total number of results.
        page:
          type: integer
          description: The current page number.
        items:
          type: array
          description: List of FBI wanted individuals.
          items:
            $ref: '#/components/schemas/FBIWantedItem'
    FBIWantedItem:
      type: object
      properties:
        title:
          type: string
          description: The title of the wanted individual (e.g., their name or alias).
        description:
          type: string
          description: Short description of the individual or the crime.
        reward:
          type: string
          description: Reward amount offered for information.
        url:
          type: string
          description: URL linking to the full FBI wanted details.
        field_offices:
          type: array
          description: List of FBI field offices related to the case.
          items:
            type: string