Search UK companies by name
company.uk.searchv1.0.0betaregion GB
Find UK registered companies matching a name or keyword and return their company numbers, status, type, incorporation date and registered address snippet so you can identify the right company before requesting its detailed records.
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/search
curl -i "https://api-staging.eckari.com/v1/companies/uk/search?q=example%20trading&limit=5"
Without credentials the gateway responds 402 with a PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE. See docs.
Use when
- Find the Companies House number for "Example Trading Limited".
- Which UK companies are called Acme Widgets?
- Look up a UK company by name.
- Resolve a business name to a company registration number.
Do not use when
- Already have the company number and want details; use company.uk.profile or company.uk.status.
- Need directors, owners, filings or charges for a known company; use the corresponding company.uk.* capability.
- Searching for people/officers rather than companies (not currently supported).
Synonyms
UK company searchCompanies House searchfind company number by namecompany name lookup UKbusiness registry search UK
Input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Company name or keyword to search for.",
"minLength": 2,
"maxLength": 200
},
"limit": {
"type": "integer",
"description": "Maximum results to return (1-50). Default 20.",
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"description": "Zero-based offset into the result set for paging.",
"minimum": 0,
"maximum": 10000
}
}
}Output schema
{
"type": "object",
"additionalProperties": false,
"required": [
"query",
"total_results",
"offset",
"items"
],
"properties": {
"query": {
"type": "string"
},
"total_results": {
"type": [
"integer",
"null"
],
"description": "Total matches reported by the register."
},
"offset": {
"type": "integer"
},
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"company_number",
"company_name",
"status",
"type",
"date_of_creation",
"address_snippet"
],
"properties": {
"company_number": {
"type": "string"
},
"company_name": {
"type": "string"
},
"status": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"date_of_creation": {
"type": [
"string",
"null"
],
"format": "date"
},
"date_of_cessation": {
"type": [
"string",
"null"
],
"format": "date"
},
"address_snippet": {
"type": [
"string",
"null"
]
},
"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"
]
}
}
}
}
}
}
}
}Example input · search_by_name
{
"q": "example trading",
"limit": 5
}Example response
{
"data": {
"query": "example trading",
"total_results": 1,
"offset": 0,
"items": [
{
"company_number": "01234567",
"company_name": "EXAMPLE TRADING LIMITED",
"status": "active",
"type": "ltd",
"date_of_creation": "2010-03-15",
"date_of_cessation": null,
"address_snippet": "1 Example Street, London, EC1A 1AA",
"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"
}
}
]
},
"meta": {
"capability": "company.uk.search",
"version": "1.0.0",
"retrieved_at": "2026-08-17T12:00:00Z",
"source": "companies_house",
"freshness": "live",
"request_id": "req_example"
}
}