> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partners.api.cobee.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get employee

## 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.


## OpenAPI

````yaml GET /companies/{companyId}/employees/{employeeId}
openapi: 3.0.1
info:
  title: Partners API
  description: >-
    Partners API definition where you can check the documentation for the
    different available operations to integrate with the platform.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://pre-partners-api.cobee.io/api/v3
  - url: https://partners-api.cobee.io/api/v3
security:
  - bearerAuth: []
paths:
  /companies/{companyId}/employees/{employeeId}:
    get:
      summary: Get employee
      parameters:
        - name: companyId
          in: path
          required: true
          description: The unique identifier of the company
          schema:
            type: string
            format: uuid
          example: a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890
        - name: employeeId
          in: path
          required: true
          description: The unique identifier of the employee
          schema:
            type: string
          example: 7f4c9ba8-9c2d-4b82-8b8c-e5f8f8f8f8f8
      responses:
        '200':
          description: Employee successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Employee'
              example:
                id: 7f4c9ba8-9c2d-4b82-8b8c-e5f8f8f8f8f8
                email: john.smith@example.com
                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:
                  id: 94379329-1c79-4c82-8857-39bb4915a4cb
                  name: Cost Center 1
                payrollCompany:
                  id: a3b77f74-68f3-4e35-8cb4-e16ece49b6a4
                  name: Payroll Company
                modelId: 7a6c9ab8-8c2d-5c82-9c8c-f5e7e7e7e7e7
                metadata:
                  department: Finance
                  manager: Jane Doe
                  office: Madrid
                state: active
        '404':
          description: Not Found - The employee ID was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Employee not found
        '500':
          description: Internal Server Error - Something went wrong on our end
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Internal server error
components:
  schemas:
    Employee:
      type: object
      required:
        - id
        - email
        - legalId
        - name
        - surname
        - birthDate
        - grossSalary
        - hiringDate
        - taxRegime
        - workdayConfiguration
        - internalId
        - modelId
        - state
      properties:
        id:
          type: string
          description: The unique identifier of the employee
        email:
          type: string
          format: email
          description: The employee's email address
        legalId:
          type: string
          description: The employee's legal identifier
        name:
          type: string
          description: The employee's first name
        surname:
          type: string
          description: The employee's surname
        birthDate:
          type: string
          format: date
          description: The employee's date of birth in ISO 8601 format (YYYY-MM-DD)
        grossSalary:
          $ref: '#/components/schemas/MonetaryAmount'
          description: The employee's gross salary details
        hiringDate:
          type: string
          format: date
          description: The date when the employee was hired in ISO 8601 format (YYYY-MM-DD)
        taxRegime:
          type: string
          enum:
            - general
            - basque
            - navarrese
            - biscayan
          description: The employee's tax regime
        workdayConfiguration:
          $ref: '#/components/schemas/WorkdayConfiguration'
          description: Configuration of the employee's workday
        internalId:
          type: string
          description: Your internal identifier for the employee
        costCenter:
          type: object
          description: The cost centre associated with this employee
          properties:
            id:
              type: string
              format: uuid
              description: The unique identifier of the cost center
            name:
              type: string
              description: The cost center name
        payrollCompany:
          type: object
          description: >-
            The company handling the employee's payroll, if different from the
            main company
          properties:
            id:
              type: string
              format: uuid
              description: The unique identifier of the subsidiary
            name:
              type: string
              description: The subsidiary name
        modelId:
          type: string
          format: uuid
          description: The ID of the benefit model assigned to this employee
        metadata:
          type: object
          description: Additional metadata for the employee (key-value pairs)
          additionalProperties: true
        state:
          type: string
          enum:
            - not-active
            - active
            - removed
            - blocked
          description: The current state of the employee
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
      example:
        message: 'Bad request: Invalid field value'
    MonetaryAmount:
      type: object
      required:
        - amountInCents
        - currency
      properties:
        amountInCents:
          type: integer
          description: The monetary amount in cents (e.g., 4500000 for 45,000)
          minimum: 1
        currency:
          type: string
          description: The currency code (e.g., EUR)
          example: EUR
      example:
        amountInCents: 4500000
        currency: EUR
    WorkdayConfiguration:
      type: object
      required:
        - workTimePercentage
      properties:
        daysPerMonth:
          type: integer
          description: The number of working days per month for this employee
          example: 22
        workTimePercentage:
          type: number
          description: The percentage of a full-time schedule this employee works
          minimum: 0.01
          maximum: 100
          example: 100
        numberOfPaychecks:
          type: integer
          description: The number of salary payments the employee receives per year
          example: 14
        collectiveAgreementSalary:
          $ref: '#/components/schemas/MonetaryAmount'
          description: The salary established by the collective agreement, if applicable
      example:
        daysPerMonth: 22
        workTimePercentage: 100
        numberOfPaychecks: 14
        collectiveAgreementSalary:
          amountInCents: 3800000
          currency: EUR
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````