Leer usuario
GET
/api/v1/users/:user_id Devuelve la ficha completa de un usuario: los mismos datos de cuenta y perfil que ve en "Mi Perfil" dentro de la app (departamento, sede, datos personales…). Un usuario de otra empresa o inexistente devuelve 404.
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
user_id | string | Sí | Identificador del usuario dentro de tu empresa. |
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
include_folders | boolean | No | Si es true, incluye las carpetas de documentos del empleado (solo metadatos). |
Ejemplo
Sustituye db_live_tu_clave por tu clave.
curl -s -H "Authorization: Bearer db_live_tu_clave" \
"https://api.dutybeat.com/api/v1/users/u-delm?include_folders=true" | jqRespuesta de ejemplo
Lo que imprime cada snippet al ejecutarlo: cURL devuelve el JSON crudo; los snippets de Python y PowerShell piden campos concretos, así que su salida es la de cada uno.
{
"data": {
"id": "u-delm",
"full_name": "Javier Ortega Marín",
"email": "[email protected]",
"role": "member",
"status": "active",
"hire_date": "2016-09-01",
"vacation_days": 23,
"works_holidays": false,
"remote_work_allowed": false,
"overtime_compensation": null,
"overtime_comp_expiry": null,
"created_at": "2016-09-01T00:00:00Z",
"has_photo": false,
"department": {
"id": "dept-delm",
"name": "Delegación Madrid"
},
"work_center": {
"id": "wc-madrid",
"name": "Madrid – Sede central"
},
"profile": {
"phone_company": "+34 910 100 007",
"phone_personal": "+34 600 100 007",
"personal_email": "[email protected]",
"birth_date": "1978-06-27",
"nationality": "Española",
"dni": "50112239G",
"dni_expiry": "2031-06-27",
"address": "Calle de Princesa 30, 5ºB",
"city": "Madrid",
"postal_code": "28008",
"passport_number": "PAH238910",
"passport_issue": "2022-04-11",
"passport_expiry": "2032-04-10",
"health_insurance": "Adeslas — Póliza nº 4471902 (cobertura internacional)",
"iban": "ES9121000418450200051332",
"swift": "CAIXESBBXXX",
"country": "España",
"company_name": "Atlántica Ingeniería S.L.",
"company_cif": "B70123456",
"ssn": "28/12345678/40",
"qualifications": [
"Ingeniero de Caminos, Canales y Puertos — Universidad Politécnica de Madrid (2009)"
]
},
"folders": [
{
"id": "contratos",
"name": "Contratos",
"document_count": 1
},
{
"id": "cursos",
"name": "Cursos de Formación",
"document_count": 1
},
{
"id": "gastos",
"name": "Gastos",
"document_count": 2
},
{
"id": "nominas",
"name": "Nóminas",
"document_count": 2
},
{
"id": "prl",
"name": "Seguridad y Salud Laboral",
"document_count": 1
}
]
}
}