ClientService

Search Companies

Searches for companies by name or registration number within a jurisdiction. Returns a list of matching companies from external data providers.

post/v1alpha2/companies:search

Request

  • Base URL: https://api.thirdfort.dev/client/api
  • URL: https://api.thirdfort.dev/client/api/v1alpha2/companies:search
  • Auth: HTTP bearer

Request body

jurisdictionstring required

Required. The jurisdiction (country) to search in. Must be a valid ISO 3166-1 alpha-2 country code (e.g., "GB", "US").

namestring

The company name to search for.

registrationNumberstring

The company registration number to search for.

dunsNumberstring

The DUNS number to search for. When set, the result is a single company looked up by its globally unique D&B identifier — used to resolve a registration number for downstream KYB-to-KYB checks.

pageSizeinteger

Optional. The maximum number of companies to return. If not specified, a default value of 10 will be used. The maximum value is 100; values above 100 will be coerced to 100. Not yet implemented: the field is accepted and ignored, a maximum of 10 results are returned in a single page.

pageTokenstring

Optional. A page token, received from a previous SearchCompanies call. Provide this to retrieve the subsequent page. Not yet implemented: the field is accepted and ignored.

statestring

Optional. The state or region within the jurisdiction to refine the search. For US, this must be a 2-character state/province code (e.g., "CA", "NY", "ON").

Response

A successful response.

nextPageTokenstring

A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to SearchCompanies. If this field is omitted, there are no subsequent pages.

Changes

No recorded changes to this operation across all 1 revision of this API.