Companies

List companies

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

Retrieves a paginated list of companies. Use cursor-based pagination by passing the nextCursor value from the response to get subsequent pages.

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

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

statusstring[]

Filter companies by status (comma-separated)

Available options:CREATEDPENDINGIN_REVIEWACTION_REQUIREDACTIVEREJECTEDRESTRICTED

Response

200Response for status 200

itemsobject[]required

Show child attributes

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

nextCursorstring | nullrequired

Cursor for next page, or null if no more items