Reference · Companies
List companies
GET
https://api.paygoro.com/v1/companiesLists the legal entities in the workspace. Most other resources belong to a company; use these ids in `companyId` filters.
Authorization
Requires a bearer API key with companies:read. See Authentication.
Response
200 · application/json
| Field | Type | Description |
|---|---|---|
data | array of object | |
id | string | Opaque resource id. |
name | string | Registered legal name. |
tradingName | string | null | |
registrationNumber | string | null | Chamber of commerce / company registry number. |
vatNumber | string | null | |
country | string | null | ISO 3166-1 alpha-2 country of incorporation. |
verificationStatus | "NotStarted" | "Pending" | "Verified" | "WaitingForInformation" | "Refused" | Know-your-business verification state for the Paygoro business account. |
createdAt | string (date-time) | Timestamp in RFC 3339 format (UTC). |
updatedAt | string (date-time) | Timestamp in RFC 3339 format (UTC). |
Errors
| 400 | BAD_REQUEST | The request was malformed or failed validation. |
| 401 | UNAUTHORIZED | Missing, malformed, expired or revoked API key. |
| 403 | FORBIDDEN | The API key does not have the scope this operation requires. |
| 404 | NOT_FOUND | No resource with this id exists in your workspace, or a `companyId` filter does not match one of your companies. |
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded. Retry after the `Retry-After` header. |
All errors share one envelope — see Errors.