NON-PRODUCTION ENVIRONMENT · STAGING · API https://api-staging.eckari.com
← All capabilities

Get UK company profile

company.uk.profilev1.0.0betaregion GB

Retrieve the core registered profile of a UK company from the official register: name, status, type, jurisdiction, incorporation and cessation dates, SIC codes, registered office address, previous names, confirmation statement and accounts summary.

Account price
USD 0.003
per successful call · introductory
x402 price
USD 0.004
accountless, settled per call · introductory
Provenance
companies_house
cache: shared · ttl 300s

Endpoint

GET https://api-staging.eckari.com/v1/companies/uk/{companyNumber}
curl -i "https://api-staging.eckari.com/v1/companies/uk/01234567"

Without credentials the gateway responds 402 with a PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE. See docs.

Use when

  • Give me the registered details for UK company 01234567.
  • When was this UK company incorporated and what type of company is it?
  • What are the SIC codes and registered office of this company?
  • Show the previous names of this limited company.

Do not use when

  • Only need to know whether the company is active or dissolved; use company.uk.status (cheaper).
  • Need directors or officers; use company.uk.directors.
  • Need beneficial owners / persons with significant control; use company.uk.owners.
  • Need filing history documents; use company.uk.filings.
  • Only have a name, not a company number; use company.uk.search first.

Synonyms

UK company detailsCompanies House company profilecompany registration detailscompany incorporation datecompany SIC codescompany overview UK

Input schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "companyNumber"
  ],
  "properties": {
    "companyNumber": {
      "type": "string",
      "description": "Companies House company number. Whitespace is ignored and short numeric values are zero-padded to 8 characters.",
      "minLength": 1,
      "maxLength": 10,
      "pattern": "^[A-Za-z0-9 ]+$"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "company_number",
    "company_name",
    "status",
    "type",
    "date_of_creation",
    "sic_codes",
    "registered_office_address",
    "previous_company_names",
    "resources"
  ],
  "properties": {
    "company_number": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Companies House company_status."
    },
    "status_detail": {
      "type": [
        "string",
        "null"
      ]
    },
    "type": {
      "type": "string",
      "description": "Companies House company type (e.g. ltd",
      "plc": null,
      "llp).": null
    },
    "subtype": {
      "type": [
        "string",
        "null"
      ]
    },
    "jurisdiction": {
      "type": [
        "string",
        "null"
      ]
    },
    "date_of_creation": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "date_of_cessation": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "can_file": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "undeliverable_registered_office_address": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "registered_office_is_in_dispute": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "sic_codes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "registered_office_address": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "properties": {
        "care_of": {
          "type": [
            "string",
            "null"
          ]
        },
        "premises": {
          "type": [
            "string",
            "null"
          ]
        },
        "address_line_1": {
          "type": [
            "string",
            "null"
          ]
        },
        "address_line_2": {
          "type": [
            "string",
            "null"
          ]
        },
        "po_box": {
          "type": [
            "string",
            "null"
          ]
        },
        "locality": {
          "type": [
            "string",
            "null"
          ]
        },
        "region": {
          "type": [
            "string",
            "null"
          ]
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "previous_company_names": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "effective_from",
          "ceased_on"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "effective_from": {
            "type": "string",
            "format": "date"
          },
          "ceased_on": {
            "type": "string",
            "format": "date"
          }
        }
      }
    },
    "confirmation_statement": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "properties": {
        "last_made_up_to": {
          "type": [
            "string",
            "null"
          ],
          "format": "date"
        },
        "next_due": {
          "type": [
            "string",
            "null"
          ],
          "format": "date"
        },
        "next_made_up_to": {
          "type": [
            "string",
            "null"
          ],
          "format": "date"
        },
        "overdue": {
          "type": [
            "boolean",
            "null"
          ]
        }
      }
    },
    "accounts": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "properties": {
        "accounting_reference_date": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": false,
          "properties": {
            "day": {
              "type": [
                "integer",
                "null"
              ]
            },
            "month": {
              "type": [
                "integer",
                "null"
              ]
            }
          }
        },
        "last_accounts": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": [
                "string",
                "null"
              ]
            },
            "period_start_on": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "period_end_on": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "made_up_to": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            }
          }
        },
        "next_accounts": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": false,
          "properties": {
            "period_start_on": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "period_end_on": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "due_on": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "overdue": {
              "type": [
                "boolean",
                "null"
              ]
            }
          }
        }
      }
    },
    "resources": {
      "type": "object",
      "description": "Which related registers exist for this company (derived from the register's resource links).",
      "additionalProperties": false,
      "required": [
        "officers",
        "persons_with_significant_control",
        "filing_history",
        "charges",
        "insolvency"
      ],
      "properties": {
        "officers": {
          "type": "boolean"
        },
        "persons_with_significant_control": {
          "type": "boolean"
        },
        "filing_history": {
          "type": "boolean"
        },
        "charges": {
          "type": "boolean"
        },
        "insolvency": {
          "type": "boolean"
        }
      }
    }
  }
}

Example input · private_limited_company

{
  "companyNumber": "01234567"
}

Example response

{
  "data": {
    "company_number": "01234567",
    "company_name": "EXAMPLE TRADING LIMITED",
    "status": "active",
    "status_detail": null,
    "type": "ltd",
    "subtype": null,
    "jurisdiction": "england-wales",
    "date_of_creation": "2010-03-15",
    "date_of_cessation": null,
    "can_file": true,
    "undeliverable_registered_office_address": false,
    "registered_office_is_in_dispute": false,
    "sic_codes": [
      "62012",
      "62020"
    ],
    "registered_office_address": {
      "care_of": null,
      "premises": null,
      "address_line_1": "1 Example Street",
      "address_line_2": null,
      "po_box": null,
      "locality": "London",
      "region": null,
      "postal_code": "EC1A 1AA",
      "country": "England"
    },
    "previous_company_names": [],
    "confirmation_statement": {
      "last_made_up_to": "2025-06-30",
      "next_due": "2026-07-14",
      "next_made_up_to": "2026-06-30",
      "overdue": false
    },
    "accounts": {
      "accounting_reference_date": {
        "day": 31,
        "month": 12
      },
      "last_accounts": {
        "type": "full",
        "period_start_on": "2024-01-01",
        "period_end_on": "2024-12-31",
        "made_up_to": "2024-12-31"
      },
      "next_accounts": {
        "period_start_on": "2025-01-01",
        "period_end_on": "2025-12-31",
        "due_on": "2026-09-30",
        "overdue": false
      }
    },
    "resources": {
      "officers": true,
      "persons_with_significant_control": true,
      "filing_history": true,
      "charges": false,
      "insolvency": false
    }
  },
  "meta": {
    "capability": "company.uk.profile",
    "version": "1.0.0",
    "retrieved_at": "2026-08-17T12:00:00Z",
    "source": "companies_house",
    "freshness": "live",
    "request_id": "req_example"
  }
}
JSONOpenAPIMCP tool metadata