Kordia

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.