CASE API

openapi: 3.1.0
info:
  title: CASE API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 5 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; CASE has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 4
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.clearancesearchengine.com/developers
paths:
  /api/v1/candor:
    get:
      operationId: get_api_v1_candor
      tags:
      - Api
      summary: 'How cases with a candor allegation (falsification, omission, or lack of candor) were resolved: favorable rate with and without
        such an allegation, deliberate and rebutted, and corrected before confron'
      x-source: https://www.clearancesearchengine.com/developers
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CandorResponse'
      x-evidence:
        kind: documentation
  /api/v1/cases:
    get:
      operationId: get_api_v1_cases
      tags:
      - Api
      summary: GET /api/v1/cases
      x-source: https://www.clearancesearchengine.com/developers
      parameters:
      - name: guideline
        in: query
        required: false
        schema:
          type: string
      - name: outcome
        in: query
        required: false
        schema:
          type: string
      - name: per_page
        in: query
        required: false
        schema:
          type: string
      - name: year_from
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Copy curl -H \"Authorization: Bearer case_live_your_key_here\"  \"https://www.clearancesearchengine.com/api/v1/cases?guideline=F&outcome=granted&year_from=2020&per_page=5\"\
          \ Python Copy import requests\nr = requests.get(\n \"https://www.clearancesearchengine.com/api/v1/cases\",\n headers={\"Authorization\"\
          : \"Bearer case_live_your_key_here\"},\n params={\"guideline\": \"F\", \"outcome\": \"granted\", \"year_from\": 2"
  /api/v1/cases/{id}:
    get:
      operationId: get_api_v1_cases_id
      tags:
      - Api
      summary: 'One decision in full: the standardized facts, each guideline with its ruling, the judge and representation, the mitigation ladder
        and the specific ¶ conditions, a concise synopsis, and the appeal outc'
      x-source: https://www.clearancesearchengine.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CasesIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/recency:
    get:
      operationId: get_api_v1_recency
      tags:
      - Api
      summary: Time between the most recent conduct and the decision, for the incident-type concerns (drugs, alcohol, criminal conduct, sexual
        behavior, protected information, IT misuse).
      x-source: https://www.clearancesearchengine.com/developers
      parameters:
      - name: guideline
        in: query
        required: false
        schema:
          type: string
        description: 'Optional single concern letter: H drugs, G alcohol, J criminal, D sexual behavior, K protected information, M IT misuse.'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1RecencyResponse'
      x-evidence:
        kind: documentation
  /api/v1/stats:
    get:
      operationId: get_api_v1_stats
      tags:
      - Api
      summary: Granted and denied counts over decided hearing-level ISCR decisions, grouped by year or by guideline.
      x-source: https://www.clearancesearchengine.com/developers
      parameters:
      - name: by
        in: query
        required: false
        schema:
          type: string
        description: year (default) or guideline.
      - name: guideline
        in: query
        required: false
        schema:
          type: string
        description: Restrict to one guideline letter, A to M.
      - name: year_from
        in: query
        required: false
        schema:
          type: integer
        description: Earliest decision year (YYYY).
      - name: year_to
        in: query
        required: false
        schema:
          type: integer
        description: Latest decision year (YYYY).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1StatsResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1CandorResponse:
      type: object
      properties:
        data:
          type: object
          description: Candor outcome breakdown.
        attribution:
          type: string
          description: Attribution string for the data.
    GetApiV1CasesIdResponse:
      type: object
      properties:
        data:
          type: object
          description: Full case object with detailed fields.
        attribution:
          type: string
          description: Attribution string for the data.
    GetApiV1RecencyResponse:
      type: object
      properties:
        data:
          type: array
          description: Recency statistics per guideline.
        scope:
          type: object
          description: Metadata about the population and guideline.
        attribution:
          type: string
          description: Attribution string for the data.
    GetApiV1StatsResponse:
      type: object
      properties:
        data:
          type: array
          description: Statistics rows (year or guideline with granted/denied counts).
        scope:
          type: object
          description: Metadata about the population and query parameters.
        attribution:
          type: string
          description: Attribution string for the data.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api