Retrieve a list
Returns a paginated list of employers.
Tip
Check the Swagger page for more technical information on the endpoints.
Endpoint details
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/employers
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-employers.read
Response properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
changeVersion |
string | — | Read-only | Property to indicate the order of changes. |
id |
integer | — | Read-only | Unique identifier for the employer. |
name.default |
string | — | Read-only | Default name of the employer. |
name.translations |
object | — | Read-only | Translated names for supported languages. |
externalCode |
string | — | Read-only | External code for the employer. |
address |
string | — | Read-only | Street address of the employer. |
town |
string | — | Read-only | Town or city of the employer. |
postalCode |
string | — | Read-only | Postal code of the employer. |
bankAccount |
string | — | Read-only | Bank account number of the employer. |
companyRegistrationNumber |
string | — | Read-only | Company registration number. |
Filters
This endpoint does not support filter parameters. It returns all employers in the system.
Pagination
This endpoint supports continuation-token pagination. When more results are available, the response includes a nextLink property containing the URL for the next page.
External references
This endpoint does not support external references.
Error responses
| Status | Condition |
|---|---|
401 |
Missing or invalid access token, or insufficient scope |
409 |
Conflict |
414 |
Request URI too long (continuation token) |
Examples
Retrieve all employers
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/employers