> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.sesametime.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an employee ## OpenAPI ````yaml GET /core/v3/employees/{id} openapi: 3.0.0 info: description: '' version: 3.0.0 title: Sesame Public API servers: - url: https://api-{region}.sesametime.com variables: region: default: eu1 security: [] tags: [] paths: /core/v3/employees/{id}: get: tags: - Employees summary: Get an employee operationId: GetEmployee parameters: - in: path name: id description: Employee ID required: true schema: type: string format: uuid responses: '200': description: Object content: application/json: schema: type: object properties: data: type: object properties: id: type: string format: uuid firstName: type: string example: Lucas lastName: type: string example: García secondLastName: type: string description: >- The employee's second last name field is only available in Mexico and Colombia nullable: true email: type: string format: email workStatus: type: string enum: - online - offline - paused - remote imageProfileURL: type: string example: >- https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png code: type: integer example: 1 pin: type: integer example: 1000 phone: type: string example: +34 111 11 11 11 company: type: object properties: id: type: string format: uuid name: type: string notificationEmail: type: string format: email language: type: string createdAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' updatedAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' gender: type: string description: >- Allowed values depend on the employee's company: | Scenario | Allowed values | |----------|----------------| | MX with ADP or Nomitek integration | female, male | | All other companies | female, male, no_response, non_binary_gender | enum: - female - male - no_response - non_binary_gender contractId: type: string description: The identifier of your internal employee contract nid: type: string description: The National Identity Document of the employee identityNumberType: type: string description: Primary identity number type enum: - dni - nie - rut - other secondaryIdentityNumberType: type: string description: Secondary identity number type enum: - dni - nie - rut - other secondaryNid: type: string description: >- The Secondary National Identity Document of the employee ssn: type: string description: The Social Security Number of the employee pricePerHour: type: number format: float description: The Price per hour of the employee accountNumber: type: string description: The Account Number of the employee dateOfBirth: type: string format: date description: '' customFields: type: array items: type: object properties: id: type: string format: uuid companyId: type: string format: uuid name: type: string slug: type: string type: type: string value: anyOf: - type: string createdAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' updatedAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' createdAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' updatedAt: type: string format: Y-m-dTH:i:sP example: '2020-01-01T10:00:00+01:00' status: type: string enum: - active - inactive children: type: integer example: 2 disability: type: integer example: 25 address: type: string description: The Address of the employee postalCode: type: string description: The postal code of the employee city: type: string description: The city of the employee province: type: string description: The province of the employee country: type: string description: >- Two-letter country code (ISO alpha-2), e.g. 'ES' for Spain, 'MX' for Mexico. nullable: true example: ES minLength: 2 maxLength: 2 nationality: type: string description: >- The nationality of the employee (deprecated: use nationalities instead) example: ES nationalities: type: array items: type: string description: The nationalities of the employee example: - ES - FR personalMail: type: string format: email nullable: true maritalStatus: type: string emergencyPhone: type: string description: The emergency phone of the employee description: type: string description: The description of the employee salaryRange: type: string description: The salary range of the employee studyLevel: type: string description: The study level of the employee professionalCategoryCode: type: string description: >- The professional category code of the employee. Use contributionGroupId instead. deprecated: true professionalCategoryDescription: type: string description: The professional category description of the employee bic: type: string jobChargeId: type: string description: The identifier of the job charge jobChargeName: type: string description: The name of the job charge jobChargeDescription: type: string description: >- The description of the job position duties and responsibilities nullable: true jobChargeCompetencies: type: string description: >- The competencies and skills required for the job position nullable: true language: type: string description: ISO language code example: es-ES workPhone: type: string description: work phone example: +34 111 11 11 11 mainRecruiter: type: object properties: id: type: string format: uuid firstName: type: string example: Lucas lastName: type: string example: García secondLastName: type: string description: >- The employee's second last name field is only available in Mexico and Colombia nullable: true imageProfileURL: type: string example: >- https://sesame-v2-prod-companies.s3.eu-west-3.amazonaws.com/48351485-1659-413d-bf7f-3ca34fadb521/public-read/g892f1fb-55a3-4e32-9cc9-7c19faa70gaa.png email: type: string format: email workStatus: type: string enum: - online - offline - paused - remote workCheckTypeColor: type: string example: '#FF0000' workCheckTypeName: type: string example: Remote nfc: type: string contributionGroupId: type: string format: uuid meta: type: object properties: currentPage: type: integer example: 1 lastPage: type: integer example: 1 total: type: integer example: 1 perPage: type: integer example: 1 security: - Bearer: [] components: securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT ````