Directors of a UK company from the Companies House officers register — the regis

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.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api-staging.eckari.com/v1/companies/uk/:company_number/directors

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "pathParams": {
    "company_number": "00445790"
  },
  "queryParams": {
    "limit": 3
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$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 \u2014 1-8 digits (zero-padded to 8, e.g. 445790 \u2192 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` \u2014 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"
}

This page as JSON