Officers

Get company officers (cached)

Every appointment at a company, current and resigned, read from Companies House (every page) and cached; served from the cache while it is under 24 hours old. A person re-appointed to the same role has a row for each appointment. When Companies House cannot be reached, the cached copy is served however old (_stale: true, with _cached_at); with no copy held the response is 503 with code companies_house_unavailable and Retry-After.

get/officers/company/{number}

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/officers/company/{number}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

numberstring required

Response

Officers list with active/resigned counts

company_numberstring required
total_resultsinteger
active_countinteger
resigned_countinteger
_source'cache' | 'companies_house'
_cached_atstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.