Companies House · Schema

officerList

CompaniesUK GovernmentBusiness RegistrationCompany SearchOfficersFiling HistoryInsolvencyChargesPersons of Significant ControlOpen Data

Properties

Name Type Description
active_count integer The number of active officers in this result set.
etag string The ETag of the resource.
items array The list of officers.
items_per_page integer The number of officers to return per page.
kind string
links object Links to other resources associated with this officer list resource.
resigned_count integer The number of resigned officers in this result set.
start_index integer The offset into the entire result set that this page starts.
total_results integer The total number of officers in this result set.
View JSON Schema on GitHub

JSON Schema

officerlist.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "officerList",
  "properties": {
    "active_count": {
      "description": "The number of active officers in this result set.",
      "type": "integer"
    },
    "etag": {
      "description": "The ETag of the resource.",
      "type": "string"
    },
    "items": {
      "description": "The list of officers.",
      "items": {
        "$ref": "http://127.0.0.1:10000/api.ch.gov.uk-specifications/swagger-2.0/spec/companyOfficerList.json#/definitions/officerSummary"
      },
      "type": "array"
    },
    "items_per_page": {
      "description": "The number of officers to return per page.",
      "type": "integer"
    },
    "kind": {
      "enum": [
        "officer-list"
      ],
      "type": "string"
    },
    "links": {
      "description": "Links to other resources associated with this officer list resource.",
      "items": {
        "$ref": "http://127.0.0.1:10000/api.ch.gov.uk-specifications/swagger-2.0/spec/companyOfficerList.json#/definitions/linkTypes"
      },
      "type": "object"
    },
    "resigned_count": {
      "description": "The number of resigned officers in this result set.",
      "type": "integer"
    },
    "start_index": {
      "description": "The offset into the entire result set that this page starts.",
      "type": "integer"
    },
    "total_results": {
      "description": "The total number of officers in this result set.",
      "type": "integer"
    }
  },
  "required": [
    "etag",
    "items_per_page",
    "kind",
    "links",
    "items",
    "start_index",
    "total_results",
    "active_count",
    "resigned_count"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/officerlist"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.