First Leeward

Companies

Upload related person documents

POSThttps://api.firstleeward.com/v0/companies/:id/related-persons/:personId/documents

Uploads one declared beneficial-owner identity document for a Universal KYB application. uboDocumentType must match a type declared for this person. Send the front image first, then the back if the document has two sides.

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

personIdstring<uuid>required

Related person identifier

Body

multipart/form-data

uboDocumentTypestringrequired

Identity document type declared for this owner. Must match a type from the pack.

Available options:PASSPORTID_CARDDRIVERS_LICENCE
filesany | any[]required

Front, then back if needed. Send a single file or repeat files (max 2, 5MB total).

Response

200Related person after uploading an identity document
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)

nextActionobject | nullrequired

Action the client must take next, or null if none remains

Show child attributes
Option 1 · Document upload
typestringrequired
documentsobject[]required

Supporting documents to upload, each with its current upload state

Show child attributes
Option 1 · Company document
documentTypestringrequired

Company supporting document to upload

Available options:CERTIFICATE_OF_INCORPORATIONCOMPANY_PROFILESHAREHOLDING_CHARTREGISTER_OF_DIRECTORSBUSINESS_REGISTRYSOURCE_OF_FUNDSSOURCE_OF_WEALTH
statusstringrequired

This document still needs to be uploaded

Option 2 · UBO document
documentTypestringrequired

Beneficial-owner identity document

relatedPersonIdstring<uuid>required

Related person this identity document belongs to

uboDocumentTypestringrequired

Identity document type declared for this owner

Available options:PASSPORTID_CARDDRIVERS_LICENCE
statusstringrequired

This document still needs to be uploaded

Option 2 · Submit
typestringrequired
400Response for status 400
Option 1 · RelatedPersonDocumentNotDeclaredError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CompanyApplicationSubmissionRejectedError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
403The requested verification method is not enabled for this project
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
404Response for status 404
Option 1 · CompanyNotFoundError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CompanyRelatedPersonNotFoundError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 3 · CompanyApplicationNotFoundError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
409Response for status 409
Option 1 · CompanyApplicationNotEditableError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CompanyApplicationNotSavedError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired