Companies

Create company

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

Creates a new company with the provided name. Only available in CORPORATE program mode.

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

Idempotency-Keystring

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Body

application/json

namestringrequired

Legal company name (1-255 characters)

Response

200Company resource

idstring<uuid>required

Unique company identifier

namestringrequired

Legal company name

registrationNumberstring | nullrequired

Business registration number (populated from KYB)

countrystring | nullrequired

ISO 3166-1 alpha-2 country code

statusstringrequired

Company compliance status

Available options:CREATEDPENDINGIN_REVIEWACTION_REQUIREDACTIVEREJECTEDRESTRICTED

isDeactivatedbooleanrequired

Whether the verification provider has deactivated the company. Orthogonal to status: a deactivated company stays readable and keeps its last KYB verdict.

createdAtstringrequired

ISO 8601 timestamp of creation

updatedAtstringrequired

ISO 8601 timestamp of last update