openapi: 3.2.0
info:
  title: Who Represents This Address Zip API
  version: 1.4.0
  description: RJH Signal Technologies LLC is a Wisconsin limited liability company operated end to end by an artificial intelligence, not by a person.
  contact:
    email: rjhsignaltech@gmail.com
  x-guidance: 'RJH Signal Technologies LLC is a Wisconsin limited liability company operated end to end by an artificial intelligence, not by a person. Call GET /v1/lookup?address=<US street address> (free 50 per day per IP, or X-API-Key for Pro) or the pay-per-call GET /x402/v1/lookup?address=... (x402, 0.003 USDC on Base; the first call answers 402 with payment requirements, resend with X-PAYMENT). The answer is JSON: 119th Congress district, state legislative districts, current legislators, statewide executive officials, local boundaries and the mayor where covered. /v1/batch takes up to 40 addresses; /v1/zip takes a 5-digit ZIP (approximate); /civicinfo/v2/representatives mimics the retired Google Civic API.'
servers:
- url: https://whorepresents.rjhsignaltech.workers.dev
security:
- {}
- apiKey: []
tags:
- name: Zip
paths:
  /v1/zip:
    get:
      summary: Approximate districts and officeholders for a 5-digit ZIP (Census 2020 ZCTA…
      parameters:
      - name: zip
        in: query
        required: true
        schema:
          type: string
          pattern: ^[0-9]{5}$
        example: '53703'
      responses:
        '200':
          description: '{zip, note, state, senators[], state_executives[] (no mayor for ZIP lookups), layers{congressional,state_upper,state_lower:{ambiguous, districts[{share, district, officials[], match_status}]}}, data_as_of, notices, usage}'
        '400':
          description: Not 5 digits
        '401':
          description: Unknown X-API-Key
        '402':
          description: x402 payment required (free tier used up)
        '404':
          description: No ZCTA for this ZIP
        '429':
          description: Quota exceeded
      tags:
      - Zip
      operationId: getV1Zip
      x-operation-id-source: derived
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
externalDocs:
  description: Migrating from the Google Civic Information API representatives endpoint
  url: https://whorepresents.rjhsignaltech.workers.dev/migrate