Skip to main content
GET
List businesses

Authorizations

Authorization
string
header
required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Query Parameters

country
string

Filter by country code (case-insensitive, e.g., GB, DE, FR, MY, SG)

entity_type
string

Filter by entity type (case-insensitive). Valid values depend on business country. Examples: limited, gmbh, bv, sl, etc.

is_archived
boolean

Filter by archived status (true/false)

Filter by legal name (case-insensitive partial match)

page
integer

Page number (default: 1)

page_size
integer

Items per page (default: 20, max: 100)

Search in business name, legal name, external ID, VAT number, and company number

Response

200 - application/json
count
integer
required

Total number of items

Example:

123

page_info
object
required
Example:
results
object[]
required