Ambolt company registry API

openapi: 3.2.0
info:
  title: Ambolt data tools company registry 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: company registry
paths:
  /v1/entity-resolve:
    get:
      operationId: entity_resolve
      summary: 'Company Registry Lookup: Name, Domain, ID, LEI to Legal Entity'
      description: 'Resolve a company name, website domain, registry number, LEI or VAT number to its official legal entity: registry, registry number, legal form, status, address, industry codes, size where published and LEI. Searches national registers (Norway, Finland, Czechia, Slovakia, France, UK, Latvia; Poland by KRS number) and GLEIF, scores the match and links every record to its source. Company-level only: no officers, no sole traders.'
      tags:
      - company registry
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: Company name, website domain (example.com), registry number, LEI or VAT number. Use this or queries.
        description: Company name, website domain (example.com), registry number, LEI or VAT number. Use this or queries.
      - name: queries
        in: query
        required: false
        schema:
          type: array
          maxItems: 100
          items:
            type: string
            maxLength: 200
          description: Up to 100 queries in one run (Apify Actor only). Each query that finds a match is one billable result.
        description: Up to 100 queries in one run (Apify Actor only). Each query that finds a match is one billable result.
      - name: country
        in: query
        required: false
        schema:
          type: string
          pattern: ^[A-Za-z]{2}$
          description: Optional ISO country code (NO, FI, CZ, SK, FR, GB, LV, EE, PL, BR, SG, CA) to search one register only. Faster and more precise.
        description: Optional ISO country code (NO, FI, CZ, SK, FR, GB, LV, EE, PL, BR, SG, CA) to search one register only. Faster and more precise.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 10
          default: 3
          description: Maximum candidates per query.
        description: Maximum candidates per query.
      - name: minScore
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 100
          default: 0
          description: 'Only return candidates with a match score of at least this value (for example 90 for KYB checks that must not accept fuzzy matches). A query with no such candidate comes back as matched: false and is not billed.'
        description: 'Only return candidates with a match score of at least this value (for example 90 for KYB checks that must not accept fuzzy matches). A query with no such candidate comes back as matched: false and is not billed.'
      - 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.010000'
        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.01 USD in USDC (x402 v2).'