List Companies

---

Retrieve a paginated list of all companies registered under your partner account.

Endpoint

Property	Value
URL	GET /white-label-partner/companies
Method	GET
Auth	R-Auth: <partner-jwt>

Example Request

curl --location '{{baseUrl}}/white-label-partner/companies?page=0&size=20' \
--header 'R-Auth: {{partnerJwt}}'

Query parameters

Parameter	Type	Required	Default	Description
page	integer	No	0	Page number, 0-indexed
size	integer	No	20	Results per page

Response

{
  "companies": [
    {
      "companyId": "f5e6d7c8-1234-5678-9abc-def012345678",
      "name": "Acme GmbH",
      "taxId": "DE123456789",
      "country": "DE",
      "createdAt": "2026-04-29T10:15:00"
    }
  ],
  "total": 1
}

Response fields

Field	Description
companies[].companyId	Company UUID
companies[].name	Company name
companies[].taxId	Tax number
companies[].country	ISO country code
companies[].createdAt	Creation timestamp
total	Total number of companies across all pages