Companies

List related persons

GEThttps://api.firstleeward.com/v0/companies/:id/related-persons

Returns a paginated list of related persons (officers and UBOs) for the company, ordered by creation date descending. Archived persons are omitted unless includeArchived is true. Use the status query parameter to filter by verification status (comma-separated), or id to fetch a single person by ID. Related persons are automatically discovered during company verification.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

idstring<uuid>required

Company identifier

Query Parameters

limitintegerdefault: 20

Maximum number of items to return (1-100, default: 20)

cursorstring

Opaque cursor for pagination. Pass nextCursor from previous response to get next page.

idstring<uuid>

Filter related persons by exact ID match

statusstring[]

Filter related persons by verification status (comma-separated)

Available options:NOT_STARTEDIN_REVIEWAPPROVEDREJECTED

includeArchivedstring

When true, include archived related persons. Defaults to false (addressable persons only).

Response

200Paginated list of related persons

itemsobject[]required

Show child attributes

idstring<uuid>required

Unique related person identifier

companyIdstring<uuid>required

Company this person belongs to

fullNamestring | nullrequired

Full name of the person

emailstring<email> | nullrequired

Email address of the person

statusstringrequired

Verification status

Available options:NOT_STARTEDIN_REVIEWAPPROVEDREJECTED

isActivebooleanrequired

Whether the related person is still addressable. False when the person has been archived.

createdAtstringrequired

When the person was added (ISO 8601)

updatedAtstringrequired

When the person was last updated (ISO 8601)

nextCursorstring | nullrequired

Cursor for next page, or null if no more items

404Company not found

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

detailobject | nullrequired