UK Company Lookup (Companies House — by Company Number)

{
  "type": "object",
  "required": [
    "company_number"
  ],
  "properties": {
    "company_number": {
      "type": "string",
      "description": "UK Companies House number (8 digits) or company name"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "e.g. 'active'."
    },
    "address": {
      "type": "string",
      "description": "The company's registered address, single-line; typically the same value as `registered_address`."
    },
    "sic_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "UK Standard Industrial Classification codes. Typically one entry."
    },
    "legal_form": {
      "type": "string",
      "description": "Typically the same value as `business_type`."
    },
    "legal_name": {
      "type": "string",
      "description": "Typically the same value as `company_name`."
    },
    "has_charges": {
      "type": "boolean"
    },
    "company_name": {
      "type": "string",
      "description": "The company's registered name."
    },
    "jurisdiction": {
      "type": "string",
      "description": "e.g. 'england-wales'."
    },
    "business_type": {
      "type": "string",
      "description": "e.g. 'plc', 'ltd'."
    },
    "company_number": {
      "type": "string",
      "description": "UK Companies House company number."
    },
    "dissolution_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Null for an active company."
    },
    "tier_2_available": {
      "type": "boolean"
    },
    "ubo_availability": {
      "type": "string",
      "description": "e.g. 'available' -- whether beneficial-ownership data exists for this company via the UK PSC register (this endpoint does not itself return that data)."
    },
    "date_incorporated": {
      "type": "string",
      "description": "YYYY-MM-DD. Typically identical to `incorporation_date`; kept as a separate field since the raw response carries both."
    },
    "incorporation_date": {
      "type": "string",
      "description": "YYYY-MM-DD. Typically identical to `date_incorporated`."
    },
    "registered_address": {
      "type": "string",
      "description": "The company's registered address, single-line -- typically identical to `address`; kept as a separate field since the raw response carries both."
    },
    "legal_representatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The officer's registered name."
          },
          "role": {
            "type": "string",
            "description": "e.g. 'director', 'secretary', 'corporate-secretary'."
          },
          "type": {
            "type": "string",
            "description": "'person' or 'organisation' -- an officer can itself be a corporate entity (e.g. a corporate secretary)."
          },
          "role_code": {
            "type": "string",
            "description": "Typically the same value as `role`."
          },
          "start_date": {
            "type": "string",
            "description": "YYYY-MM-DD appointment date."
          }
        },
        "additionalProperties": true
      },
      "description": "The company's current officers (directors and company secretary), from the UK Companies House Officers register, e.g. 11 entries for Tesco PLC, 3 for Google UK Limited."
    },
    "primary_registration_id": {
      "type": "string",
      "description": "Typically the same value as `company_number`."
    },
    "tier_2_available_reason": {
      "type": "string"
    },
    "ubo_availability_reason": {
      "type": "string"
    },
    "total_legal_representatives": {
      "type": "number",
      "description": "Count of `legal_representatives` entries."
    }
  },
  "description": "The company record.",
  "additionalProperties": true
}