Companies

List related person applications

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

Returns a paginated list of related person KYC applications for the company, ordered by creation date descending. Use the status query parameter to filter by application status (comma-separated), or relatedPersonId to scope to a single related person.

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

Unique 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 by exact application ID match

relatedPersonIdstring<uuid>

Filter by related person ID

statusstring[]

Filter by application status (comma-separated)

Available options:INITIATEDIN_PROGRESSAPPROVEDREJECTEDREVIEW_REQUIREDWORKFLOW_ERROREXPIRED

Response

200Paginated list of related person applications

itemsobject[]required

Show child attributes

idstring<uuid>required

Unique company application identifier

companyIdstring<uuid>required

Company this application belongs to

statusstringrequired

Application lifecycle status

Available options:INITIATEDIN_PROGRESSAPPROVEDREJECTEDREVIEW_REQUIREDWORKFLOW_ERROREXPIRED

sessionUrlstring | nullrequired

URL for the corporate client to complete verification

expiresAtstring | nullrequired

When the verification session URL expires (ISO 8601)

createdAtstringrequired

When the application was created (ISO 8601)

updatedAtstringrequired

When the application was last updated (ISO 8601)

relatedPersonIdstring<uuid>required

Related person this application belongs to

nextCursorstring | nullrequired

Cursor for next page, or null if no more items

404Company not found

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

detailobject | nullrequired