Officers

Search officers by name

Every director, secretary and LLP member on the Companies House register, by name (Companies House's officer search, cached for six hours). Each result is a person or corporate officer with their date of birth (month and year), number of appointments and correspondence address; pass officer_id to GET /officers/{officer_id}/appointments for their appointments. When the search allowance for Companies House is used up the response is 503 with code search_busy and Retry-After.

get/officers/search

Request

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

Query parameters

namestring required
limitinteger
offsetinteger

Response

People found: { query, total, limit, offset, results: [{ officer_id, name, date_of_birth, appointment_count, address, description, kind }] }

Changes

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