Listar imputaciones
GET
/api/v1/allocations Devuelve a qué proyecto fue cada tramo de tiempo trabajado en el rango (ambos extremos incluidos, máximo 366 días), con su duración en minutos y las observaciones de quien lo imputó. `project` es null cuando el tramo fue a «otras tareas», y entonces la descripción va en `note`: siempre hay uno de los dos. Es información de gestión y no altera el registro de jornada.
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
from | string | Sí | Primer día del rango (YYYY-MM-DD). |
to | string | Sí | Último día del rango (YYYY-MM-DD), incluido. |
user_id | string | No | Solo las imputaciones de este empleado. |
project_id | string | No | Solo las imputaciones a este proyecto. |
tz | string | No | Zona horaria IANA con la que se agrupan los días. |
page | integer | No | Página (desde 1). |
page_size | integer | No | Imputaciones por página (máx. 100). |
Ejemplo
Sustituye db_live_tu_clave por tu clave.
curl -s -H "Authorization: Bearer db_live_tu_clave" \
"https://api.dutybeat.com/api/v1/allocations?from=2026-06-02&to=2026-06-02&user_id=u-delm" | jq Respuesta 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": "alloc-delm-0602m",
"user_id": "u-delm",
"date": "2026-06-02",
"start": "2026-06-02T07:00:00.000Z",
"end": "2026-06-02T12:00:00.000Z",
"minutes": 300,
"project": {
"id": "tenant-001:prj-2",
"code": "PRJ-0002",
"name": "Nave logística ACME"
},
"note": null,
"comment": null,
"source": "auto",
"created_at": "2026-06-02T12:00:00.000Z"
},
{
"id": "alloc-delm-0602t1",
"user_id": "u-delm",
"date": "2026-06-02",
"start": "2026-06-02T13:00:00.000Z",
"end": "2026-06-02T16:00:00.000Z",
"minutes": 180,
"project": {
"id": "tenant-001:prj-2",
"code": "PRJ-0002",
"name": "Nave logística ACME"
},
"note": null,
"comment": null,
"source": "auto",
"created_at": "2026-06-02T16:00:00.000Z"
},
{
"id": "alloc-delm-0602t2",
"user_id": "u-delm",
"date": "2026-06-02",
"start": "2026-06-02T16:00:00.000Z",
"end": "2026-06-02T17:30:00.000Z",
"minutes": 90,
"project": {
"id": "tenant-001:int-2",
"code": "INT-0002",
"name": "Soporte a compañero"
},
"note": null,
"comment": "Ayuda a Elena con el cálculo de la viga carril",
"source": "manual",
"created_at": "2026-06-02T17:30:00.000Z"
}
],
"meta": {
"page": 1,
"page_size": 25,
"total": 3
}
}