Skip to main content
GET
/
companies
/
{companyId}
/
employees
/
{employeeId}
Get employee
curl --request GET \
  --url https://pre-public-api.cobee.io/api/v3/companies/{companyId}/employees/{employeeId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "7f4c9ba8-9c2d-4b82-8b8c-e5f8f8f8f8f8",
  "email": "[email protected]",
  "legalId": "12345678Z",
  "name": "John",
  "surname": "Smith",
  "birthDate": "1985-07-15",
  "grossSalary": {
    "amountInCents": 4500000,
    "currency": "EUR"
  },
  "hiringDate": "2023-01-10",
  "taxRegime": "general",
  "workdayConfiguration": {
    "daysPerMonth": 22,
    "workTimePercentage": 100,
    "numberOfPaychecks": 14,
    "collectiveAgreementSalary": {
      "amountInCents": 3800000,
      "currency": "EUR"
    }
  },
  "internalId": "EMP-1234",
  "costCenter": "Finance",
  "payrollCompany": "Main Branch",
  "modelId": "7a6c9ab8-8c2d-5c82-9c8c-f5e7e7e7e7e7",
  "metadata": {
    "department": "Finance",
    "manager": "Jane Doe",
    "office": "Madrid"
  },
  "state": "active"
}

​
Overview

This endpoint allows you to retrieve detailed information about a specific employee in the Cobee system. It returns comprehensive data including personal information, salary details, workday configuration, and benefit-related information.

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 unique identifier of the company

​
employeeId
string
required

The unique identifier of the employee

Response

Employee successfully retrieved

​
id
string
required

The unique identifier of the employee

​
email
string<email>
required

The employee's email address

​
legalId
string
required

The employee's legal identifier

​
name
string
required

The employee's first name

​
surname
string
required

The employee's surname

​
birthDate
string<date>
required

The employee's date of birth in ISO 8601 format (YYYY-MM-DD)

​
grossSalary
object
required

The employee's gross salary details

Example:
{
  "amountInCents": 4500000,
  "currency": "EUR"
}
​
hiringDate
string<date>
required

The date when the employee was hired in ISO 8601 format (YYYY-MM-DD)

​
taxRegime
enum<string>
required

The employee's tax regime

Available options:
general,
basque,
navarrese,
biscayan
​
workdayConfiguration
object
required

Configuration of the employee's workday

Example:
{
  "daysPerMonth": 22,
  "workTimePercentage": 100,
  "numberOfPaychecks": 14,
  "collectiveAgreementSalary": {
    "amountInCents": 3800000,
    "currency": "EUR"
  }
}
​
internalId
string
required

Your internal identifier for the employee

​
modelId
string<uuid>
required

The ID of the benefit model assigned to this employee

​
state
enum<string>
required

The current state of the employee

Available options:
not-active,
active,
removed,
blocked
​
costCenter
string

The cost centre associated with this employee

​
payrollCompany
string

The company handling the employee's payroll, if different from the main company

​
metadata
object

Additional metadata for the employee (key-value pairs)