Consultar una solicitud ARCOP

Propósito

Obtiene una solicitud ARCOP por su UUID dentro de la organización de la credencial. Requiere el permiso requests:read.

Método y ruta

GET /api/v1/organizations/:organization/requests/:request

• :organization: identificador Hub o UUID de la organización de la credencial.
• :request: UUID entregado en el campo uuid de una solicitud.

La consulta agrega el organizationId. Una solicitud de otro tenant no se expone y produce 404.

curl

curl --fail-with-body \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  "$BASE_URL/api/v1/organizations/$ORGANIZATION/requests/d539f65e-e982-46af-a7ea-9ae01d452227"

Respuesta 200

{
  "id": 42,
  "uuid": "d539f65e-e982-46af-a7ea-9ae01d452227",
  "requestType": "portability",
  "status": "in_progress",
  "source": "public",
  "subjectType": "email",
  "subjectValueHash": "b5fc85e55755f9e0d030a10ab4429b6b2944855f9a0d60077fe832becbc41d72",
  "affectedCount": 3,
  "notes": null,
  "dueAt": "2026-09-21T18:00:00.000+00:00",
  "slaState": "on_time",
  "escalated": false,
  "extensionRequestedAt": null,
  "extensionReason": null,
  "identityPending": false,
  "identityVerifiedAt": "2026-08-22T18:20:00.000+00:00",
  "identityVerificationMethod": "otp",
  "resolvedAt": null,
  "createdAt": "2026-08-22T18:00:00.000+00:00",
  "updatedAt": "2026-08-23T03:30:00.000+00:00"
}

Errores relevantes

• 401: credencial ausente o inválida.
• 403: la credencial no tiene requests:read.
• 404: la solicitud no existe, pertenece a otro tenant o :organization no es el de la credencial.

Semántica y límites

• source indica por dónde entró la solicitud: admin (plataforma), public (portal del titular) o api.
• identityVerificationMethod puede ser otp (código enviado al correo del titular), manual (revisión de un operador) o channel.
• La respuesta nunca incluye subjectValue ni nombres de operadores.
• Consultar una solicitud no modifica su estado.

Los UUID, IDs y fechas son ilustrativos; los campos de la respuesta corresponden al contrato publicado.