Centro de documentación
Guía 06/GET/api/v1/organizations/:organization/requests

Listar solicitudes ARCOP

Filtra y pagina solicitudes ARCOP de una organización por tipo, estado y reloj SLA con GET /requests.

Índice de guías

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 tiene requests:read.
  • 404: :organization no es la organización de la credencial.
  • 422: un filtro, page o perPage no cumple las reglas.

Semántica y límites

  • dueAt y slaState reflejan el reloj de 30 días corridos; escalated indica que la plataforma ya alertó por vencimiento.
  • identityPending señala que el titular todavía no acreditó identidad; las acciones sobre datos esperan esa verificación.
  • La metadata de paginación usa snake_case y 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.

¿Necesitas el contrato exhaustivo?Revisa parámetros, esquemas y respuestas de todas las operaciones en la referencia.Abrir referencia
WhatsApp