Skip to main content
GET
/
companies
/
{companyId}
/
employees
/
{employeeId}
/
limits
Get employee limits
curl --request GET \
  --url https://pre-partners-api.cobee.io/api/v3/companies/{companyId}/employees/{employeeId}/limits \
  --header 'Authorization: Bearer <token>'
{
  "company": {
    "id": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
    "legalId": "B12345678",
    "currency": "EUR",
    "payrollCycle": {
      "id": "7f4c9ba8-9c2d-4b82-8b8c-e5f8f8f8f8f8",
      "start": 1672531200,
      "end": 1675123200,
      "fiscalYear": "2023",
      "payrollMonth": "03"
    },
    "employee": {
      "employeeId": "dd3de3a0-f903-42a0-b729-4cb16f185bc6",
      "internalId": "12345",
      "legalId": "129387655X",
      "limits": {
        "meal": {
          "amount": {
            "amountInCents": 1,
            "currency": "EUR"
          },
          "appliesTo": "employee",
          "period": "payroll",
          "type": "recurrent",
          "disabled": false
        },
        "transport": {
          "amount": {
            "amountInCents": 1,
            "currency": "EUR"
          },
          "appliesTo": "employee",
          "period": "payroll",
          "type": "punctual",
          "disabled": false
        },
        "nursery": {
          "amount": {
            "amountInCents": 1,
            "currency": "EUR"
          },
          "appliesTo": "employee",
          "period": "payroll",
          "type": "recurrent",
          "disabled": false
        }
      }
    }
  }
}

​
Overview

This endpoint allows you to retrieve the employee limits for all the benefits defined by the partner, such as meals, transport and nurseries. You can optionally filter by a specific payroll cycle using the payroll query parameter (format YYYY-MM).If not provided, the limits for the current payroll cycle are returned. Past payroll cycles are not allowed.
  • Current payroll cycle: If the parameter matches the current cycle (or is omitted), the response includes the current payroll cycle details.
  • Future payroll cycles: If the parameter is for a future payroll cycle, the payrollCycle object will have id/start/end: null, as the cycle has not yet opened.
  • Past payroll cycles: Querying for past payroll cycles is not allowed and will return a 400 Bad Request.
You can also filter the response by specific benefit categories using the categories query parameter. The response will include only the requested categories in the order they were provided. The response includes the appliesTo field for each benefit, indicating whether the limit applies to the employee or a child, along with the amount.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
companyId
string<uuid>
required

The company identifier

​
employeeId
string
required

The employee identifier

Query Parameters

​
payroll
string

The fiscal year and month (YYYY-MM) of the payroll cycle the limits belong to (e.g. 2025-03). If not provided, the current payroll cycle limits are returned. Past payroll cycles are not allowed.

Example:

"2025-03"

​
categories
string

List of benefit categories to include in the response, which will return them in the same order as requested.

​
csvFormat
enum<string>
default:lines

The format of the resulting limits. Only applicable when Accept is text/csv.

  • lines: One row per limit (default).
  • columns: One row per employee, with columns for each benefit category (amount and appliesTo).
Available options:
lines,
columns

Response

Employee limits

​
company
object
required