Propósito
Obtiene las solicitudes ARCOP de la organización, ordenadas por createdAt DESC y luego por id DESC. Requiere el permiso requests:read.
Método y ruta
GET /api/v1/organizations/:organization/requests
Query string
| Campo | Tipo | Obligatorio | Reglas |
|---|---|---|---|
requestType |
enum | No | access, rectification, erasure, objection, portability |
status |
enum | No | pending, in_progress, completed, rejected |
slaState |
enum | No | overdue, due_soon, on_time, completed_on_time, completed_late |
page |
number | No | Mínimo 1; valor por defecto 1. |
perPage |
number | No | Entre 1 y 100; valor por defecto 20. |
curl
curl --fail-with-body \
-H "Authorization: Bearer $TOKEN" \
-H 'Accept: application/json' \
"$BASE_URL/api/v1/organizations/$ORGANIZATION/requests?slaState=due_soon&page=1&perPage=20"
Respuesta 200
{
"data": [
{
"id": 42,
"uuid": "d539f65e-e982-46af-a7ea-9ae01d452227",
"requestType": "rectification",
"status": "pending",
"source": "api",
"subjectType": "email",
"subjectValueHash": "b5fc85e55755f9e0d030a10ab4429b6b2944855f9a0d60077fe832becbc41d72",
"affectedCount": 1,
"notes": "Pidió corregir su dirección.",
"dueAt": "2026-09-22T04:00:00.000+00:00",
"slaState": "due_soon",
"escalated": false,
"extensionRequestedAt": null,
"extensionReason": null,
"identityPending": true,
"identityVerifiedAt": null,
"identityVerificationMethod": null,
"resolvedAt": null,
"createdAt": "2026-08-23T04:00:00.000+00:00",
"updatedAt": "2026-08-23T04:00:00.000+00:00"
}
],
"metadata": {
"total": 1,
"per_page": 20,
"current_page": 1,
"last_page": 1,
"first_page": 1,
"first_page_url": "/?page=1",
"last_page_url": "/?page=1",
"next_page_url": null,
"previous_page_url": null
}
}
Errores relevantes
401: credencial ausente, inválida, expirada o revocada.403: la credencial no tienerequests:read.404::organizationno es la organización de la credencial.422: un filtro,pageoperPageno cumple las reglas.
Semántica y límites
dueAtyslaStatereflejan el reloj de 30 días corridos;escalatedindica que la plataforma ya alertó por vencimiento.identityPendingseñala que el titular todavía no acreditó identidad; las acciones sobre datos esperan esa verificación.- La metadata de paginación usa
snake_casey sus enlaces son/?page=N: reconstruye la URL con la ruta y filtros de tu integración. - La respuesta expone
subjectValueHash, no el identificador original.
Los UUID, IDs y fechas del ejemplo son ilustrativos; la estructura corresponde al contrato publicado.