Ambolt secretary of state API

openapi: 3.2.0
info:
  title: Ambolt data tools secretary of state API
  version: 0.1.1
  description: Pay-per-call data endpoints using the x402 protocol (USDC on Base, Polygon and Solana). Failed calls are not charged.
  x-guidance: 'Call GET /v1/<tool> with the documented query parameters. Without payment the response is 402 with the price and payment requirements; an x402 client pays in USDC and retries. Add free=1 for one free call per tool and IP per day. Company, tender, document, rates, on-chain and web tools; every response carries source and date. The same tools are available as MCP tools at /mcp (free, 30 requests a minute) and as Apify Actors. Company-level data only: no personal data.'
  contact:
    email: hello@ambolt.dev
    url: https://ambolt.dev
servers:
- url: https://api.ambolt.dev
security: []
tags:
- name: secretary of state
paths:
  /v1/us-business-entities:
    get:
      operationId: us_business_entities
      summary: 'US Business Entity Search: Colorado, Connecticut, New York'
      description: 'Look up US companies in official state business registers (Colorado, Connecticut, New York) or list newly formed entities by date: legal name, entity type, status, formation date, state of formation and city, with the source dataset. Official open data, one schema. Company level only: no registered agents, owners, officers, e-mail addresses or street addresses; trade names and sole proprietorships are excluded.'
      tags:
      - secretary of state
      parameters:
      - name: states
        in: query
        required: false
        schema:
          type: array
          maxItems: 3
          items:
            type: string
            enum:
            - CO
            - CT
            - NY
          description: 'States to search: CO, CT, NY. Default: all three.'
        description: 'States to search: CO, CT, NY. Default: all three.'
      - name: name
        in: query
        required: false
        schema:
          type: string
          minLength: 3
          maxLength: 80
          pattern: ^[\p{L}\p{N} .,&'-]+$
          description: Part of the legal name (at least 3 characters).
        description: Part of the legal name (at least 3 characters).
      - name: status
        in: query
        required: false
        schema:
          type: string
          maxLength: 30
          description: Filter by status (for example Active, Good Standing, Delinquent). New York lists active entities only.
        description: Filter by status (for example Active, Good Standing, Delinquent). New York lists active entities only.
      - name: entityType
        in: query
        required: false
        schema:
          type: string
          maxLength: 40
          description: Filter by entity type text (for example LLC, Corporation, DLLC).
        description: Filter by entity type text (for example LLC, Corporation, DLLC).
      - name: formedSince
        in: query
        required: false
        schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: Only entities formed or registered on or after this date (YYYY-MM-DD). Use the date of your last run for new formations.
        description: Only entities formed or registered on or after this date (YYYY-MM-DD). Use the date of your last run for new formations.
      - name: formedUntil
        in: query
        required: false
        schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: Only entities formed or registered on or before this date.
        description: Only entities formed or registered on or before this date.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 200
          default: 25
          description: Maximum entities per state. Each returned entity is one billable result.
        description: Maximum entities per state. Each returned entity is one billable result.
      - name: free
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: Set to 1 for one free call per tool and IP address per day (no payment).
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Result (JSON). Every result names its source and the time it was read.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input; not charged.
        '402':
          description: 'Payment required: 0.02 USD in USDC (x402 v2).'