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, same value observed as `registered_address` on both real fixtures."
    },
    "sic_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "UK Standard Industrial Classification codes. One entry on each real fixture observed."
    },
    "legal_form": {
      "type": "string",
      "description": "Same value as `business_type` on both real fixtures."
    },
    "legal_name": {
      "type": "string",
      "description": "Same value as `company_name` on both real fixtures."
    },
    "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' -- observed on both real fixtures."
    },
    "company_number": {
      "type": "string",
      "description": "UK Companies House company number."
    },
    "dissolution_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Observed null on both real fixtures (both companies are active)."
    },
    "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. Identical to `incorporation_date` on both real fixtures; kept as a separate field since the raw response carries both."
    },
    "incorporation_date": {
      "type": "string",
      "description": "YYYY-MM-DD. Identical to `date_incorporated` on both real fixtures."
    },
    "registered_address": {
      "type": "string",
      "description": "The company's registered address, single-line -- identical to `address` on both real fixtures observed; 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, observed on one real fixture (a corporate secretary)."
          },
          "role_code": {
            "type": "string",
            "description": "Same value as `role` on both real fixtures observed."
          },
          "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. 11 entries on the larger fixture observed (Tesco PLC), 3 on the smaller (Google UK Limited)."
    },
    "primary_registration_id": {
      "type": "string",
      "description": "Same value as `company_number` on both real fixtures."
    },
    "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, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}