openapi: 3.2.0
info:
  title: Who Represents This Address Batch 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: Batch
paths:
  /v1/batch:
    post:
      summary: Look up 1 to 40 U.S.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - addresses
              properties:
                addresses:
                  type: array
                  minItems: 1
                  maxItems: 40
                  items:
                    type: string
                    maxLength: 300
            example:
              addresses:
              - 2 E Main St, Madison, WI 53703
              - 350 5th Ave, New York, NY 10118
      responses:
        '200':
          description: JSON {results:[one /v1/lookup-shaped object per address, in input order; failed addresses carry input, error (no_match|geocoder_unavailable|invalid_address|batch_deadline_exceeded) and message], count, matched, data_as_of, notices, usage}. invalid_address and batch_deadline_exceeded items are not counted against the quota.
        '400':
          description: Invalid JSON, missing addresses, or more than 40 addresses
        '401':
          description: Unknown X-API-Key (carries upgrade_url)
        '413':
          description: Body over 64 KB
        '429':
          description: 'The batch would exceed the remaining quota (free tier: carries upgrade_url); nothing is counted'
      tags:
      - Batch
      operationId: postV1Batch
      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