First Leeward

Companies

Advance company application

POSThttps://api.firstleeward.com/v0/companies/:id/applications

Advances the company application. For Managed KYB, send redirectUri (the default when method is omitted) to get a verification URL for the corporate client. Returns an error if an active Managed application already exists. For Universal KYB, send method: UNIVERSAL_KYB and the verified business pack. The first call creates the application; later calls amend it and return the same application until it is submitted. nextAction is null for Managed KYB.

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

Body

application/json

Option 1 · Managed KYB
methodstringdefault: "MANAGED_KYB"

Must match the KYB verification method configured on your project. Defaults to MANAGED_KYB when omitted.

redirectUristring<uri>required

URL to redirect to after company verification completes

Option 2 · Universal KYB
legalBusinessNamestringrequired
legalFormOfCompanystringrequired
Available options:PRIVATE_LIMITEDPUBLIC_LIMITEDLLCLLPPARTNERSHIPSOLE_PROPRIETORSHIPTRUSTCORPORATEOTHER
businessRegistrationNumberstringrequired
uboDeclarationobject[]required
Show child attributes
externalUserIdstringrequired
ownershipPctnumberrequired
identityobjectrequired
Show child attributes
firstNamestringrequired
middleNamestring
lastNamestringrequired
fullNamestringrequired
dobstringrequired
nationalitystringrequired

ISO 3166-1 alpha-3 country code

documentobject[]required
Show child attributes
documentCategorystringrequired
typestringrequired
Available options:PASSPORTID_CARDDRIVERS_LICENCE
numberstringrequired
countrystringrequired

ISO 3166-1 alpha-3 country code

issuingDatestring
expiryDatestring
addressobjectrequired
Show child attributes
countrystringrequired

ISO 3166-1 alpha-3 country code

formattedAddressstringrequired
postCodestring
streetstring
townstring
subStreetstring
statestring
buildingNamestring
flatNumberstring
buildingNumberstring
registeredAddressobjectrequired
Show child attributes
line1stringrequired
line2stringrequired
citystringrequired
statestring
postalCodestring
countrystringrequired

ISO 3166-1 alpha-3 country code

principalPlaceOfBusinessAddressobjectrequired
Show child attributes
line1stringrequired
line2stringrequired
citystringrequired
statestring
postalCodestring
countrystringrequired

ISO 3166-1 alpha-3 country code

validEmailDomainsstring[]required
lineOfBusinessstringrequired
Available options:PROFESSIONAL_SERVICESCONSULTING_SERVICESHUMAN_RESOURCES_RECRUITMENTBUSINESS_PROCESS_OUTSOURCINGRESEARCH_DEVELOPMENTINFORMATION_TECHNOLOGY_SOFTWARETELECOMMUNICATIONSRETAIL_TRADEWHOLESALE_TRADEE_COMMERCEMANUFACTURINGCONSTRUCTION_ENGINEERINGLOGISTICS_TRANSPORTATIONHEALTHCARE_SERVICESEDUCATION_TRAININGREAL_ESTATE_SERVICESHOSPITALITY_TOURISMMEDIA_ADVERTISINGAGRICULTURE_FARMINGFINTECHPAYMENT_SERVICE_PROVIDERMONEY_SERVICES_BUSINESS_REMITTANCEFOREIGN_EXCHANGE_SERVICESINSURANCELENDING_CREDIT_SERVICESINVESTMENT_ASSET_MANAGEMENTREGULATED_FINANCIAL_SERVICES_LICENSE_REQUIREDVIRTUAL_ASSET_SERVICE_PROVIDERCRYPTOCURRENCY_EXCHANGEBLOCKCHAIN_INFRASTRUCTUREDIGITAL_ASSET_CUSTODYDECENTRALISED_FINANCEGOVERNMENT_ENTITYSTATE_OWNED_ENTERPRISEINTERNATIONAL_ORGANISATIONNON_PROFIT_ORGANISATIONCHARITY_FOUNDATIONGAMING_GAMBLINGADULT_ENTERTAINMENTPRECIOUS_METALS_STONESAUCTION_HOUSE_ART_DEALERCASH_INTENSIVE_BUSINESSPOLITICALLY_EXPOSED_ORGANISATIONTRUST_COMPANY_SERVICE_PROVIDERHOLDING_COMPANYCONGLOMERATEOTHER
dateOfIncorporationstring
businessWebsiteUrlstring<uri>
ddqobject
Show child attributes
cardAuthoritiesobject[]required
Show child attributes
fullNamestringrequired
rolestringrequired
expectedSpendProfileobjectrequired
Show child attributes
spendBucketsobject[]required
Show child attributes
namestringrequired
expectedSpendUsdnumberrequired
jurisdictionIsostring

ISO 3166-1 alpha-3 country code

txnPatternobject
Show child attributes
frequencystring
avgTicketUsdnumber
peakDaysstring[]
Available options:MONTUEWEDTHUFRISATSUN
numberOfEmployeesinteger
eddobject
Show child attributes
sourceOfFundsDeclarationstringrequired
sourceOfWealthDeclarationstringrequired
methodstringrequired

Must match the KYB verification method configured on your project

Response

200Company application created or amended
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)

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 · InvalidDeclaredOwnershipError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CompanyApplicationIncompleteError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 3 · 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
404Company not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
409Response for status 409
Option 1 · ActiveCompanyApplicationExistsError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CompanyApplicationNotEditableError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
500Company application template is not configured for this project. Please contact support.
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired