{ "x402Version": 2, "id": 4312, "slug": "4312", "resource": "https://api.eckari.com/v1/companies/uk/:company_number/directors", "description": "Directors of a UK company from the Companies House officers register — the register of directors, secretaries and LLP members — including corporate and nominee directors, with appointment and resignation dates, nationality, country of residence, occupation, month/year of birth and correspondence address. role and include_resigned widen it. Use when: Identify who is legally responsible for a UK company - the directors on the Companies House officers register.", "type": "http", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0x9d6b6fdB04040a55d58B24ff4C90C08cf6083C8f", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "5000", "maxTimeoutSeconds": 60 } ], "outputSchema": { "bazaar": { "info": { "input": { "method": "GET", "pathParams": { "company_number": "00445790" }, "queryParams": { "limit": 3 }, "type": "http" }, "output": { "example": { "data": { "company_number": "00445790", "items": [ { "address": { "address_line_1": "Shire Park", "address_line_2": "Kestrel Way", "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "po_box": null, "postal_code": "AL7 1GA", "premises": "Tesco House", "region": null }, "appointed_on": "2018-09-24", "country_of_residence": "United Kingdom", "date_of_birth": { "month": 9, "year": 1974 }, "identification": null, "is_active": true, "name": "BETHELL, Melissa", "nationality": "British", "occupation": null, "officer_status": "active", "resigned_on": null, "role": "director" }, { "address": { "address_line_1": "Shire Park", "address_line_2": "Kestrel Way", "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "po_box": null, "postal_code": "AL7 1GA", "premises": "Tesco House", "region": null }, "appointed_on": "2021-06-01", "country_of_residence": "England", "date_of_birth": { "month": 6, "year": 1975 }, "identification": null, "is_active": true, "name": "BODSON, Bertrand Jean Francois", "nationality": "Belgian", "occupation": null, "officer_status": "active", "resigned_on": null, "role": "director" }, { "address": { "address_line_1": "Tesco House, Shire Park", "address_line_2": "Kestrel Way", "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "po_box": null, "postal_code": "AL7 1GA", "premises": null, "region": null }, "appointed_on": "2023-09-01", "country_of_residence": "United Kingdom", "date_of_birth": { "month": 12, "year": 1960 }, "identification": null, "is_active": true, "name": "FAIRBAIRN, Carolyn Julie", "nationality": "British", "occupation": null, "officer_status": "active", "resigned_on": null, "role": "director" } ], "officer_totals": { "active": 11, "inactive": 0, "resigned": 63 }, "page": { "has_more": true, "limit": 3, "next_offset": 4, "offset": 0, "returned": 3, "total": null }, "query": { "include_resigned": false, "role": "director" } }, "meta": { "capability": "company.uk.directors", "freshness": "live", "source": "companies_house", "version": "3.1.0" } }, "type": "json" } }, "routeTemplate": "/v1/companies/uk/:company_number/directors", "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "pathParams": { "additionalProperties": false, "properties": { "company_number": { "description": "Companies House company number, also called the company registration number (CRN). Accepted shapes are the register's own — 1-8 digits (zero-padded to 8, e.g. 445790 → 00445790), one letter + 7 digits (R0000001), two letters + 6 digits (SC002180, NI000001, OC123456, OE000001), or the registered-society suffix forms (two letters + 5 digits + 1 letter; two letters + 4 digits + 2 letters). Case-insensitive; surrounding whitespace is ignored (which is why maxLength is 10); internal spaces and punctuation are not accepted. Any other value (for example PROBE) is rejected as INVALID_INPUT before payment and before any upstream call.", "maxLength": 10, "minLength": 1, "pattern": "^\\s*(?:[0-9]{1,8}|[A-Za-z][0-9]{7}|[A-Za-z]{2}[0-9]{6}|[A-Za-z]{2}[0-9]{5}[A-Za-z]|[A-Za-z]{2}[0-9]{4}[A-Za-z]{2})\\s*$", "type": "string" } }, "required": [ "company_number" ], "type": "object" }, "queryParams": { "additionalProperties": false, "properties": { "include_resigned": { "description": "Include resigned officers. Default false.", "type": "boolean" }, "limit": { "description": "Maximum officers to return per page (1-100). Default 5. Eckari reads up to three register pages of 100 entries to fill this after the role and resigned filters are applied; if the limit is still unmet, page.has_more is true and page.next_offset says where to resume.", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "description": "Zero-based index into the register's own officer list (not into the filtered result). Pass back page.next_offset from the previous response to page.", "maximum": 10000, "minimum": 0, "type": "integer" }, "role": { "description": "Which appointments to return. Default `director` — the capability's name is its contract. The register encodes the office in officer_role, so the filter is a substring test on it: `director` matches director, corporate-director, nominee-director and corporate-nominee-director; `secretary` matches secretary, corporate-secretary, nominee-secretary and corporate-nominee-secretary; `llp_member` matches llp-member, llp-designated-member and their corporate- forms; `all` returns every appointment the register lists, including managing officers, general partners, judicial factors and the EEIG/SE organ roles. Filtering is applied after the register read, so read page.has_more rather than items.length.", "enum": [ "director", "secretary", "llp_member", "all" ], "type": "string" } }, "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "payment-identifier": { "info": { "required": false }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "id": { "maxLength": 128, "minLength": 16, "pattern": "^[a-zA-Z0-9_-]+$", "type": "string" }, "required": { "type": "boolean" } }, "required": [ "required" ], "type": "object" } } }, "tags": [ "bazaar", "payment-identifier" ], "sourceHost": "api.eckari.com", "lastUpdated": "2026-08-27T22:36:22.172Z", "quality": { "calls30d": 3, "uniquePayers30d": 2, "lastCalledAt": "2026-08-27T22:36:21.708Z" }, "liveness": {}, "verified": false, "featured": false, "provider": { "host": "api.eckari.com", "manifest_name": "api.eckari.com", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-09-18T22:00:31.484Z" } }