Axiom Works AgentReader

Axiom Works AgentReader Us Entity API

The Us Entity API from Axiom Works AgentReader — 2 operation(s) for us entity.

GitHub OpenAPI

Operations 3

GET /us-entity Use this for a US state business-entity (Secretary of State) lookup across New… #
POST /us-entity Use this for a US state business-entity (Secretary of State) lookup across New… #
GET /us-entity/{state}/{id} Path alias of /us-entity (same price/x402 challenge). #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/axiomworks-co-uk/openapi/axiomworks-co-uk-us-entity-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/axiomworks-co-uk:axiomworks-co-uk-us-entity-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

axiomworks-co-uk-us-entity-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Axiom Works AgentReader Us Entity API
  version: 1.45.0
  contact:
    email: info@axiomworks.co.uk
    url: https://github.com/grokbot1233/agentreader
  description: 'x402 pay-per-call APIs for AI agents: KYB packs, UK due diligence, company research, UK/AU/CA/FR/NO/DK/FI/CH/PL/CZ/BE/SK/IE/EE/LV/SG + US-state (NY/CO/CT/OR/TX/VA) registries, LEI, sanctions, SEC EDGAR, VIES VAT, web reading, document conversion, change monitoring, EVM/FX. Big hitters first (/kyb, /uk-dd, /uk-company, /uk-watch, /uk-leads, /company-full, /sanctions-batch). Payments: USDC on Base mainnet (eip155:8453).'
servers:
- url: https://api.axiomworks.co.uk
tags:
- name: Us Entity
paths:
  /us-entity:
    get:
      summary: Use this for a US state business-entity (Secretary of State) lookup across New…
      parameters:
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: Company/entity name (prefix + exact match, legal suffix optional), e.g. Etsy Inc
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Alias of name
      - name: company
        in: query
        required: false
        schema:
          type: string
        description: Alias of name
      - name: state
        in: query
        required: false
        schema:
          type: string
        description: NY, CO, CT, OR, TX, VA, comma list, or all (default all). Required (single state) for id lookup
      - name: id
        in: query
        required: false
        schema:
          type: string
        description: 'State entity id: NY DOS ID, CO entity id, CT account number, OR registry number, TX taxpayer number, VA SCC entity ID'
      - name: number
        in: query
        required: false
        schema:
          type: string
        description: Alias of id
      - name: entity_id
        in: query
        required: false
        schema:
          type: string
        description: Alias of id
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Results (1-25, default 10)
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: object
                  total_results:
                    type: integer
                  best_match:
                    type: object
                    description: state, id, name, status, entity_type, formed, jurisdiction, address, registered_agent, principals (CT), lookup_url
                  results:
                    type: array
                  red_flags:
                    type: array
                  per_state:
                    type: object
                  source:
                    type: string
        '400':
          description: Bad input
        '402':
          description: 'Payment required: $0.25 USDC on Base (x402 v2, see PAYMENT-REQUIRED header)'
      x-price: $0.25
      x-payment-info:
        mode: fixed
        currency: USD
        amount: '0.25'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x88b1c747c33A5868A34057D8C57318E5602b3ff6'
        amountAtomic: '250000'
      x-402:
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount: '250000'
      x-buyer-sheet: https://api.axiomworks.co.uk/buy/us-entity
      tags:
      - Us Entity
      operationId: getUsEntity
      x-operation-id-source: derived
    post:
      summary: Use this for a US state business-entity (Secretary of State) lookup across New…
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Company/entity name (prefix + exact match, legal suffix optional), e.g. Etsy Inc
                q:
                  type: string
                  description: Alias of name
                company:
                  type: string
                  description: Alias of name
                state:
                  type: string
                  description: NY, CO, CT, OR, TX, VA, comma list, or all (default all). Required (single state) for id lookup
                id:
                  type: string
                  description: 'State entity id: NY DOS ID, CO entity id, CT account number, OR registry number, TX taxpayer number, VA SCC entity ID'
                number:
                  type: string
                  description: Alias of id
                entity_id:
                  type: string
                  description: Alias of id
                limit:
                  type: integer
                  description: Results (1-25, default 10)
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: object
                  total_results:
                    type: integer
                  best_match:
                    type: object
                    description: state, id, name, status, entity_type, formed, jurisdiction, address, registered_agent, principals (CT), lookup_url
                  results:
                    type: array
                  red_flags:
                    type: array
                  per_state:
                    type: object
                  source:
                    type: string
        '400':
          description: Bad input
        '402':
          description: 'Payment required: $0.25 USDC on Base (x402 v2, see PAYMENT-REQUIRED header)'
      x-price: $0.25
      x-payment-info:
        mode: fixed
        currency: USD
        amount: '0.25'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x88b1c747c33A5868A34057D8C57318E5602b3ff6'
        amountAtomic: '250000'
      x-402:
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount: '250000'
      tags:
      - Us Entity
      operationId: postUsEntity
      x-operation-id-source: derived
  /us-entity/{state}/{id}:
    get:
      summary: Path alias of /us-entity (same price/x402 challenge).
      parameters:
      - name: state
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: chain
        in: query
        required: false
        schema:
          type: string
      - name: preview
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: object
                  total_results:
                    type: integer
                  best_match:
                    type: object
                    description: state, id, name, status, entity_type, formed, jurisdiction, address, registered_agent, principals (CT), lookup_url
                  results:
                    type: array
                  red_flags:
                    type: array
                  per_state:
                    type: object
                  source:
                    type: string
        '402':
          description: 'Payment required: $0.25 USDC on Base (x402)'
      x-price: $0.25
      x-alias-of: /us-entity
      tags:
      - Us Entity
      operationId: getUsEntityByStateById
      x-operation-id-source: derived