registercheckby openlaw group
API referencePeople

List a person's positions

GET
/persons/{person_id}/positions

The offices and interests a person holds or held: officer appointments, shareholdings and limited partnerships, each with the company it concerns.

Costs 10 credits. The first page is free with GET /persons/{person_id}?expand=positions.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_live_….

In: header

Path Parameters

person_id*string

The person's id.

Formatuuid

Query Parameters

limit?integer

Page size.

Range1 <= value <= 100
Default20
starting_after?string

Return the page after the object with this id. Cannot be combined with ending_before.

Formatuuid
ending_before?string

Return the page before the object with this id. Cannot be combined with starting_after.

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/persons/497f6eca-6276-4993-bfeb-53cbbbba6f08/positions"
{  "object": "list",  "has_more": true,  "url": "string",  "data": [    {      "object": "person_position",      "kind": "officer",      "company": {        "object": "company",        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      },      "officer_role": "managing_director",      "status": "current",      "match_confidence": 0    }  ]}