Listar proyectos

GET /api/v1/projects

Devuelve el catálogo de proyectos y actividades internas de la empresa, de más reciente a más antiguo. El `code` (PRJ-0001 para proyectos, INT-0001 para actividades internas) es el identificador estable con el que casar tus propios ids: no cambia nunca. Un proyecto archivado (`status: inactive`) conserva su histórico pero ya no admite imputaciones nuevas.

Parámetros de consulta

Nombre Tipo Obligatorio Descripción
status string No Filtra por estado: 'active' o 'inactive'.
kind string No Filtra por tipo: 'project' (trabajo real) o 'internal' (actividad interna).
page integer No Página (desde 1).
page_size integer No Proyectos 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/projects?kind=project&page_size=2" | 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": "tenant-001:prj-1",
      "code": "PRJ-0001",
      "name": "Puente sobre el Miño",
      "description": "Proyecto estructural para la Xunta de Galicia",
      "kind": "project",
      "status": "active",
      "created_at": "2026-06-01T00:00:00Z"
    },
    {
      "id": "tenant-001:prj-2",
      "code": "PRJ-0002",
      "name": "Nave logística ACME",
      "description": "Cálculo y dirección de obra de nave industrial en Getafe",
      "kind": "project",
      "status": "active",
      "created_at": "2026-06-01T00:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 2,
    "total": 3
  }
}

Prueba la demo

Déjanos tus datos y accede a tu entorno de prueba al instante.

Para acceder deberás leer y aceptar nuestra Política de Privacidad.

Política de Privacidad

Léela hasta el final para poder continuar.

Al solicitar la demo de DutyBeat tratamos los datos que nos facilitas (nombre, email y teléfono) con el único fin de crear tu entorno de prueba, facilitarte el enlace de acceso y atender tu solicitud comercial. La demo es solo para mayores de 18 años, lo que confirmas en el formulario.

Responsable: DutyBeat. Base jurídica: tu consentimiento y el interés legítimo en responder a tu solicitud. Conservación: el entorno de demo se elimina automáticamente al caducar; conservamos tus datos de contacto como lead comercial un máximo de 12 meses.

No cedemos tus datos a terceros salvo obligación legal ni para fines distintos a los descritos. Puedes ejercer tus derechos de acceso, rectificación, supresión, oposición, limitación y portabilidad escribiendo a [email protected].

Puedes consultar la versión completa en nuestra página de Política de Privacidad.

Al pulsar “He leído y acepto” confirmas haber leído esta información y consientes el tratamiento de tus datos para los fines indicados.