API de consulta¶

Consulta desde tu backend lo que ha emitido tu organización: el detalle de una emisión por su identificador, el listado de lo emitido y la búsqueda de las atestaciones de una persona por un dato propio, como el DNI. Sin pasar por el Portal de Administración.

Contrato OpenAPI de consulta API de emisión

Estado de las funciones¶

La guía describe el contrato completo de la API. Algunas partes aún no están desplegadas: están marcadas como Próximamente en su sección y no conviene usarlas hasta que lo estén.

Detalle de una emisión¶

GET /issuer/api/v1/issuances/{id}

{id} es el identificador del proceso de emisión: el que devuelve la emisión en la cabecera Location, o el procedure_id de un listado o una búsqueda. La respuesta incluye los datos de la atestación en credential.

GET /issuer/api/v1/issuances/0b6f1d2e-8c4a-4b1f-9e2d-7a5c3f8e1b90 HTTP/1.1
Host: sandbox.stg.eudistack.net
Authorization: Bearer <access_token>

{
  "procedure_id": "0b6f1d2e-8c4a-4b1f-9e2d-7a5c3f8e1b90",
  "organization_identifier": "VATES-B00000000",
  "credential_configuration_id": "learcredential.employee.w3c.4",
  "credential_format": "jwt_vc_json",
  "lifeCycleStatus": "VALID",
  "subject": "María García López",
  "email": "maria.garcia@empresa.example",
  "delivery": "email",
  "valid_from": "2026-10-01T09:12:44Z",
  "valid_until": "2027-10-01T09:12:44Z",
  "created": "2026-10-01T09:10:02Z",
  "created_by": "sistema-rrhh@empresa.example",
  "updated": "2026-10-01T09:12:44Z",
  "credential": { "...": "datos de la atestación" }
}

Cada acceso al detalle queda registrado, porque devuelve datos personales. Pídelo solo cuando necesites los datos de la atestación: para saber el estado basta el listado o la búsqueda.

Un proceso que no existe y uno que está fuera de tu ámbito reciben la misma respuesta: 404 issuance_not_found.

Estados de un proceso de emisión¶

Listar lo emitido¶

GET /issuer/api/v1/issuances

Devuelve los procesos de emisión de tu ámbito, del más reciente al más antiguo y en todos los estados. Los filtros se combinan entre sí:

Para recorrer todo el listado, repite la petición con cursor igual al next_cursor recibido hasta que valga null. El listado no incluye los datos de la atestación: para verlos, pide el detalle.

{
  "credential_procedures": [
    {
      "credential_procedure": {
        "procedure_id": "0b6f1d2e-8c4a-4b1f-9e2d-7a5c3f8e1b90",
        "organization_identifier": "VATES-B00000000",
        "credential_type": "learcredential.employee.w3c.4",
        "status": "VALID",
        "subject": "María García López",
        "updated": "2026-10-01T09:12:44Z"
      }
    }
  ],
  "next_cursor": null
}

Buscar por un identificador de la persona¶

GET /issuer/api/v1/issuances?identifier_type=<tipo>&identifier=<valor>

Cada tipo de atestación del catálogo de tu tenant puede declarar identificadores de búsqueda: datos de la atestación por los que después se busca, como el DNI (dni) o el número de colegiado (colegiado). Los nombres los define el catálogo de tu tenant.

GET /issuer/api/v1/issuances?identifier_type=dni&identifier=12345678Z&status=VALID HTTP/1.1
Host: sandbox.stg.eudistack.net
Authorization: Bearer <access_token>

• La coincidencia es exacta. Envía el valor con el mismo formato con el que se emitió y codifícalo en la URL.
• identifier_type e identifier van siempre juntos. Uno sin el otro se rechaza con 400 BAD_REQUEST.
• Un identifier_type que no declara ningún tipo del catálogo se rechaza con 400 unknown_identifier_type.
• Una búsqueda sin resultados no es un error: devuelve 200 con la lista vacía.
• Se combina con los filtros del listado, por ejemplo con status=VALID para encontrar lo que se puede revocar.

EUDIStack no busca el valor en claro. Al emitir guarda una huella de cada identificador, calculada con una clave propia de tu tenant, y al buscar compara la huella del valor recibido. Las huellas se calculan también para lo emitido antes de que el identificador existiera en el catálogo.

Errores¶

Los errores se devuelven como application/problem+json (RFC 9457). Programa tu lógica sobre type, no sobre title ni detail.

El límite de volumen de la búsqueda es más bajo que el del listado y el detalle (60 frente a 300 peticiones por minuto y organización para sistemas), para impedir que se recorra el censo de personas.

Referencia completa¶

El contrato completo de la API de consulta, con todos los campos, respuestas y códigos de error, está en la referencia de la API del Issuer.