Leer recurso

Devuelve un recurso con sus contratos y asignaciones en modo lectura. Opcionalmente puede incluir la matriz mensual de horas asignadas por proyecto.

GET /api/v1/resources/:id

Path parameters

| Nombre | Tipo | Requerido | Descripción | | --- | --- | --- | --- | | id | integer | Sí | ID del recurso en Kordia. |

Query parameters

| Nombre | Tipo | Requerido | Descripción | | --- | --- | --- | --- | | include | string | No | Usa monthly_hours para incluir la matriz mensual de horas asignadas. | | from | date | No | Fecha inicial para la matriz mensual del recurso. Debe usarse junto con to. | | to | date | No | Fecha final para la matriz mensual del recurso. Debe usarse junto con from. |

curl "https://app.example.com/api/v1/resources/7?include=monthly_hours&from=2026-06-01&to=2026-09-30" \
  -H "Authorization: Bearer $KORDIA_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(
  "https://app.example.com/api/v1/resources/7?include=monthly_hours&from=2026-06-01&to=2026-09-30",
  { headers: { Authorization: `Bearer ${process.env.KORDIA_API_KEY}` } }
)

const resource = (await response.json()).data

import os
import requests

response = requests.get(
    "https://app.example.com/api/v1/resources/7?include=monthly_hours&from=2026-06-01&to=2026-09-30",
    headers={"Authorization": f"Bearer {os.environ['KORDIA_API_KEY']}"},
)

resource = response.json()["data"]

Req.get!(
  "https://app.example.com/api/v1/resources/7?include=monthly_hours&from=2026-06-01&to=2026-09-30",
  headers: [authorization: "Bearer #{System.fetch_env!("KORDIA_API_KEY")}"]
).body["data"]

Respuesta

{
  "data": {
    "id": 7,
    "external_id": "employee-456",
    "name": "Ana García",
    "tags": [],
    "contracts": [
      {
        "id": 5,
        "start_date": "2026-06-01",
        "end_date": null,
        "daily_hours": 8,
        "annual_convention_hours": 1800,
        "cost_per_hour": "50.00"
      }
    ],
    "assignments": [
      {
        "id": 42,
        "project_id": 10,
        "project_title": "Proyecto Atlas",
        "resource_id": 7,
        "resource_name": "Ana García",
        "start_date": "2026-06-01",
        "end_date": "2026-06-30",
        "daily_hours": 4.0,
        "cost_per_hour": "50.00",
        "cost_source": "contract_default"
      }
    ],
    "monthly_hours": {
      "months": ["2026-06", "2026-07", "2026-08", "2026-09"],
      "projects": [
        {
          "project_id": 10,
          "project_title": "Proyecto Atlas",
          "months": {
            "2026-06": 78.9,
            "2026-07": 80,
            "2026-08": 0,
            "2026-09": 0
          },
          "total_hours": 158.9
        }
      ],
      "totals": {
        "2026-06": 78.9,
        "2026-07": 80,
        "2026-08": 0,
        "2026-09": 0
      },
      "grand_total": 158.9
    }
  }
}

Uso recomendado

Usa esta respuesta para sincronizar disponibilidad ya planificada en Kordia hacia sistemas externos de reporting, CRM, ERP o BI.

Si pides include=monthly_hours sin from/to, Kordia usa el rango completo de asignaciones del recurso. Para acotar la respuesta, envía ambos parámetros como fechas ISO 8601.