Axiom Works AgentReader Uk Company API

The Uk Company API from Axiom Works AgentReader — 2 operation(s) for uk company.

GitHub OpenAPI

Operations 3

GET /uk-company Use this for UK due diligence on a Companies House number or name: official API… #
POST /uk-company Use this for UK due diligence on a Companies House number or name: official API… #
GET /uk-company/{number} Path alias of /uk-company (same price/x402 challenge). #

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-uk-company-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.

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

OpenAPI Specification

axiomworks-co-uk-uk-company-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Axiom Works AgentReader Uk Company 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: Uk Company
paths:
  /uk-company:
    get:
      summary: 'Use this for UK due diligence on a Companies House number or name: official API…'
      parameters:
      - name: number
        in: query
        required: false
        schema:
          type: string
        description: UK Companies House number, e.g. 00445790
      - name: company_number
        in: query
        required: false
        schema:
          type: string
        description: Alias of number (Companies House field name)
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: Registered company name to search
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  company_number:
                    type: string
                  profile:
                    type: object
                  overview:
                    type: object
                  officers:
                    type: object
                  persons_with_significant_control:
                    type: object
                  filing_history_highlights:
                    type: object
                  charges:
                    type: object
                  compliance:
                    type: object
                  red_flags:
                    type: array
                    items:
                      type: object
                  sources:
                    type: object
              example:
                _example: Shape of a real paid response for TESCO PLC (00445790), captured 2026-11-07 from Companies House public data; arrays trimmed to 2-3 items; values in <angle brackets> vary per company.
                ok: true
                mode: companies_house_api
                company_number: 00445790
                profile:
                  name: TESCO PLC
                  number: 00445790
                  status: active
                  status_detail: null
                  type: plc
                  incorporation_date: '1947-11-27'
                  dissolution_date: null
                  jurisdiction: england-wales
                  sic_codes:
                  - '47110'
                  registered_office:
                    address_line_1: Tesco House, Shire Park
                    address_line_2: Kestrel Way
                    locality: Welwyn Garden City
                    country: United Kingdom
                    postal_code: AL7 1GA
                  registered_office_text: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  accounts:
                    accounting_reference_date:
                      day: '26'
                      month: '02'
                    last_accounts:
                      made_up_to: '2026-02-28'
                      type: group
                    next_due: '2027-08-26'
                    overdue: false
                  confirmation_statement:
                    overdue: false
                  has_been_liquidated: false
                  has_insolvency_history: false
                  has_charges: true
                  previous_company_names:
                  - name: TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY
                    ceased_on: '1983-08-25'
                  source: https://api.company-information.service.gov.uk/company/00445790
                officers:
                  active_count: 35
                  resigned_count: null
                  total_results: 74
                  items:
                  - name: TAYLOR, Christopher Jon
                    role: secretary
                    appointed_on: '2025-04-14'
                    resigned_on: null
                    nationality: null
                    country_of_residence: null
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  - name: BETHELL, Melissa
                    role: director
                    appointed_on: '2018-09-24'
                    resigned_on: null
                    nationality: British
                    country_of_residence: United Kingdom
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  - name: BODSON, Bertrand Jean Francois
                    role: director
                    appointed_on: '2021-06-01'
                    resigned_on: null
                    nationality: Belgian
                    country_of_residence: null
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  source: https://api.company-information.service.gov.uk/company/00445790/officers?items_per_page=50
                persons_with_significant_control:
                  available: false
                  persons: []
                  reason: likely exempt (e.g. listed/public company with no PSC resource items)
                  source: https://api.company-information.service.gov.uk/company/00445790/persons-with-significant-control?items_per_page=50
                filing_history_highlights:
                  items:
                  - date: '2026-09-16'
                    type: SH03
                    category: capital
                    description: 'Purchase of own shares. ANNOTATION Clarification hmrc confirmation received that appropriate duty has been paid on this '
                    action_date: null
                  - date: '2026-08-26'
                    type: SH06
                    category: capital
                    description: Cancellation of shares. Statement of capital on 7 July 2026 GBP 397,007,409.26
                    action_date: null
                  source: https://api.company-information.service.gov.uk/company/00445790/filing-history?items_per_page=25
                charges:
                  total_count: 9
                  outstanding: 2
                  satisfied: 7
                  part_satisfied: 0
                  items:
                  - status: outstanding
                    created_on: <date>
                    delivered_on: <date>
                    classification: <charge type>
                    persons_entitled:
                    - <lender>
                  source: https://api.company-information.service.gov.uk/company/00445790/charges
                insolvency:
                  cases: []
                  has_insolvency_history: false
                  note: no insolvency resource
                  source: https://api.company-information.service.gov.uk/company/00445790/insolvency
                compliance:
                  accounts_overdue: false
                  confirmation_statement_overdue: false
                mass_formation_office:
                  matched: false
                  label: null
                  address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                red_flags:
                - flag: outstanding_charges
                  reason: 2 outstanding charge(s) registered
                  severity: medium
                sources:
                  profile: https://api.company-information.service.gov.uk/company/00445790
                  web: https://find-and-update.company-information.service.gov.uk/company/00445790
                queried_at: '2026-11-07T11:00:00.000Z'
                search: null
                cache: MISS
        '400':
          description: Bad input
        '402':
          description: 'Payment required: $0.50 USDC on Base (x402 v2, see PAYMENT-REQUIRED header)'
      x-price: $0.50
      x-payment-info:
        mode: fixed
        currency: USD
        amount: '0.50'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x88b1c747c33A5868A34057D8C57318E5602b3ff6'
        amountAtomic: '500000'
      x-402:
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount: '500000'
      x-buyer-sheet: https://api.axiomworks.co.uk/buy/uk-company
      tags:
      - Uk Company
      operationId: getUkCompany
      x-operation-id-source: derived
    post:
      summary: 'Use this for UK due diligence on a Companies House number or name: official API…'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                  description: UK Companies House number, e.g. 00445790
                company_number:
                  type: string
                  description: Alias of number (Companies House field name)
                name:
                  type: string
                  description: Registered company name to search
              anyOf:
              - required:
                - number
              - required:
                - company_number
              - required:
                - name
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  company_number:
                    type: string
                  profile:
                    type: object
                  overview:
                    type: object
                  officers:
                    type: object
                  persons_with_significant_control:
                    type: object
                  filing_history_highlights:
                    type: object
                  charges:
                    type: object
                  compliance:
                    type: object
                  red_flags:
                    type: array
                    items:
                      type: object
                  sources:
                    type: object
              example:
                _example: Shape of a real paid response for TESCO PLC (00445790), captured 2026-11-07 from Companies House public data; arrays trimmed to 2-3 items; values in <angle brackets> vary per company.
                ok: true
                mode: companies_house_api
                company_number: 00445790
                profile:
                  name: TESCO PLC
                  number: 00445790
                  status: active
                  status_detail: null
                  type: plc
                  incorporation_date: '1947-11-27'
                  dissolution_date: null
                  jurisdiction: england-wales
                  sic_codes:
                  - '47110'
                  registered_office:
                    address_line_1: Tesco House, Shire Park
                    address_line_2: Kestrel Way
                    locality: Welwyn Garden City
                    country: United Kingdom
                    postal_code: AL7 1GA
                  registered_office_text: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  accounts:
                    accounting_reference_date:
                      day: '26'
                      month: '02'
                    last_accounts:
                      made_up_to: '2026-02-28'
                      type: group
                    next_due: '2027-08-26'
                    overdue: false
                  confirmation_statement:
                    overdue: false
                  has_been_liquidated: false
                  has_insolvency_history: false
                  has_charges: true
                  previous_company_names:
                  - name: TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY
                    ceased_on: '1983-08-25'
                  source: https://api.company-information.service.gov.uk/company/00445790
                officers:
                  active_count: 35
                  resigned_count: null
                  total_results: 74
                  items:
                  - name: TAYLOR, Christopher Jon
                    role: secretary
                    appointed_on: '2025-04-14'
                    resigned_on: null
                    nationality: null
                    country_of_residence: null
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  - name: BETHELL, Melissa
                    role: director
                    appointed_on: '2018-09-24'
                    resigned_on: null
                    nationality: British
                    country_of_residence: United Kingdom
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  - name: BODSON, Bertrand Jean Francois
                    role: director
                    appointed_on: '2021-06-01'
                    resigned_on: null
                    nationality: Belgian
                    country_of_residence: null
                    occupation: null
                    address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                  source: https://api.company-information.service.gov.uk/company/00445790/officers?items_per_page=50
                persons_with_significant_control:
                  available: false
                  persons: []
                  reason: likely exempt (e.g. listed/public company with no PSC resource items)
                  source: https://api.company-information.service.gov.uk/company/00445790/persons-with-significant-control?items_per_page=50
                filing_history_highlights:
                  items:
                  - date: '2026-09-16'
                    type: SH03
                    category: capital
                    description: 'Purchase of own shares. ANNOTATION Clarification hmrc confirmation received that appropriate duty has been paid on this '
                    action_date: null
                  - date: '2026-08-26'
                    type: SH06
                    category: capital
                    description: Cancellation of shares. Statement of capital on 7 July 2026 GBP 397,007,409.26
                    action_date: null
                  source: https://api.company-information.service.gov.uk/company/00445790/filing-history?items_per_page=25
                charges:
                  total_count: 9
                  outstanding: 2
                  satisfied: 7
                  part_satisfied: 0
                  items:
                  - status: outstanding
                    created_on: <date>
                    delivered_on: <date>
                    classification: <charge type>
                    persons_entitled:
                    - <lender>
                  source: https://api.company-information.service.gov.uk/company/00445790/charges
                insolvency:
                  cases: []
                  has_insolvency_history: false
                  note: no insolvency resource
                  source: https://api.company-information.service.gov.uk/company/00445790/insolvency
                compliance:
                  accounts_overdue: false
                  confirmation_statement_overdue: false
                mass_formation_office:
                  matched: false
                  label: null
                  address: Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA
                red_flags:
                - flag: outstanding_charges
                  reason: 2 outstanding charge(s) registered
                  severity: medium
                sources:
                  profile: https://api.company-information.service.gov.uk/company/00445790
                  web: https://find-and-update.company-information.service.gov.uk/company/00445790
                queried_at: '2026-11-07T11:00:00.000Z'
                search: null
                cache: MISS
        '400':
          description: Bad input
        '402':
          description: 'Payment required: $0.50 USDC on Base (x402 v2, see PAYMENT-REQUIRED header)'
      x-price: $0.50
      x-payment-info:
        mode: fixed
        currency: USD
        amount: '0.50'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x88b1c747c33A5868A34057D8C57318E5602b3ff6'
        amountAtomic: '500000'
      x-402:
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        amount: '500000'
      tags:
      - Uk Company
      operationId: postUkCompany
      x-operation-id-source: derived
  /uk-company/{number}:
    get:
      summary: Path alias of /uk-company (same price/x402 challenge).
      parameters:
      - name: number
        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:
                  company_number:
                    type: string
                  profile:
                    type: object
                  overview:
                    type: object
                  officers:
                    type: object
                  persons_with_significant_control:
                    type: object
                  filing_history_highlights:
                    type: object
                  charges:
                    type: object
                  compliance:
                    type: object
                  red_flags:
                    type: array
                    items:
                      type: object
                  sources:
                    type: object
        '402':
          description: 'Payment required: $0.50 USDC on Base (x402)'
      x-price: $0.50
      x-alias-of: /uk-company
      tags:
      - Uk Company
      operationId: getUkCompanyByNumber
      x-operation-id-source: derived