Saltar al contenido principal
GET

Obtener el contrato activo de un empleado

Scope:team:employees.read
https://api.holded.com/api/v2/employees/{employeeId}/contract

Returns all fields of the employee's active contract. Use this as the first step before updating a contract field: fetch the current data here, then send ALL fields back to the PUT endpoint modifying only what you want to change. Field names in this response match exactly the field names expected by the PUT endpoint.

Parámetros

Parámetros de ruta

employeeIdstringobligatorio

ID del empleado (ObjectId hexadecimal de 24 caracteres)

Petición

python
import requests

url = "https://api.holded.com/api/v2/employees/{employeeId}/contract"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respuestas

Respuesta

json
{}

Respuestas exitosas

200Datos del contrato activoapplication/json
object

Respuestas de error

401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Empleado o contrato activo no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json