Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Officers and directors API

registry.officers

Directors, officers and significant controllers for a registered entity.
providers document it
5

Providers

5 providers document officers and directors in their own API docs. None routes it through GridRouter yet. Scores appear as calls are routed.

What counts as a hit:
At least one officer is returned for the entity.

API

Same input for every provider. Set provider.sort to route by price, reliability or latency, or provider.only to pin providers; X-Grid-Max-Cost caps what one call can spend.

Inputs for registry.officers
InputDescription
registration_number*Registry number (required)
Request
curl https://api.gridrouter.io/v1/run/registry.officers \
  -H "Authorization: Bearer $GRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Grid-Max-Cost: 0.05" \
  -d '{"input":{"registration_number":"01234567"},"provider":{"sort":"price"}}'

Fields

The normalized output every provider maps into. Suppliers come from integrated endpoint mappings (verified) or field names in each provider's API docs (claimed by the provider).

Every capability's fields
Output fields for Officers and directors
FieldTypePIIDescriptionSupplied by
namestringIdentifierOfficer nameNorth DataOpenCorporates
rolestringNoneRoleOpenCorporates
appointed_ondateNoneAppointed onOpenCorporates
resigned_ondateNoneResigned onOpenCorporates
nationalitystringIdentifierNationalityNot mapped yet
date_of_birthobjectSensitiveMonth and year of birth where publishedNot mapped yet