---
title: "Sovra ID API"
---

> Documentation Index
> Fetch the complete documentation index at: https://sovra-id-docs-1044960690985.us-central1.run.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sovra ID API

API servidor-a-servidor de Sovra ID. Las zonas `issuer` y `verifier` se autentican con una API key de workspace (`Authorization: Bearer sovra_sk_...`).

Esta referencia se generó a partir de las colecciones de Postman del repositorio `sovrahq/id-docs`. La especificación completa se publica en `GET {baseUrl}/openapi/api`.

Version: v1

## Servers

- `https://test-api-sovra.flagonsa.com`
- `https://api.sovra.io`

## [Credenciales](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/credenciales/)

Ciclo de vida de emisión de credenciales, acotado al workspace de la API key.

- [Crear oferta de credencial](https://sovra-id-docs-1044960690985.us-central1.run.app/api/create-credential-offer/) — `POST /api/v1/issuer/credential-offer`
- [Listar credenciales emitidas](https://sovra-id-docs-1044960690985.us-central1.run.app/api/list-credentials/) — `GET /api/v1/issuer/credentials`
- [Consultar una credencial](https://sovra-id-docs-1044960690985.us-central1.run.app/api/get-credential/) — `GET /api/v1/issuer/credentials/{credentialId}`
- [Revocar credencial](https://sovra-id-docs-1044960690985.us-central1.run.app/api/revoke-credential/) — `PUT /api/v1/issuer/credentials/{credentialId}/status/revoked`
- [Suspender credencial](https://sovra-id-docs-1044960690985.us-central1.run.app/api/suspend-credential/) — `PUT /api/v1/issuer/credentials/{credentialId}/status/suspended`
- [Reactivar credencial suspendida](https://sovra-id-docs-1044960690985.us-central1.run.app/api/reactivate-credential/) — `PUT /api/v1/issuer/credentials/{credentialId}/status/issued`

## [Esquemas](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/esquemas/)

Creación y consulta de esquemas de credenciales.

- [Consultar esquemas (leer docType y namespace)](https://sovra-id-docs-1044960690985.us-central1.run.app/api/list-schemas/) — `GET /api/v1/issuer/schemas`
- [Crear esquema mDoc con namespace propio](https://sovra-id-docs-1044960690985.us-central1.run.app/api/create-schema/) — `POST /api/v1/issuer/schemas`

## [Verificaciones](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/verificaciones/)

Sesiones de verificación OID4VP, acotadas al workspace de la API key.

- [Listar sesiones de verificación](https://sovra-id-docs-1044960690985.us-central1.run.app/api/list-verifications/) — `GET /api/v1/verifier/verifications`
- [Crear sesión de verificación](https://sovra-id-docs-1044960690985.us-central1.run.app/api/create-verification/) — `POST /api/v1/verifier/verifications`
- [Consultar una sesión de verificación](https://sovra-id-docs-1044960690985.us-central1.run.app/api/get-verification/) — `GET /api/v1/verifier/verifications/{verificationId}`

## [Documentos firmados](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/documentos-firmados/)

Emisión, visibilidad, listado y lectura pública de documentos firmados.

- [Listar documentos del workspace](https://sovra-id-docs-1044960690985.us-central1.run.app/api/list-documents/) — `GET /api/v1/issuer/documents`
- [Emitir documento](https://sovra-id-docs-1044960690985.us-central1.run.app/api/issue-document/) — `POST /api/v1/issuer/documents`
- [Cambiar visibilidad → public](https://sovra-id-docs-1044960690985.us-central1.run.app/api/make-document-public/) — `PUT /api/v1/issuer/documents/{documentId}/visibility/public`
- [Cambiar visibilidad → private](https://sovra-id-docs-1044960690985.us-central1.run.app/api/make-document-private/) — `PUT /api/v1/issuer/documents/{documentId}/visibility/private`
- [Obtener documento (JSON)](https://sovra-id-docs-1044960690985.us-central1.run.app/api/documents/retrieve/) — `GET /api/v1/documents/{documentId}`

## [Listas de estado](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/listas-de-estado/)

Listas de estado de revocación y suspensión. No requieren autenticación.

- [Lista de estado (revocación)](https://sovra-id-docs-1044960690985.us-central1.run.app/api/get-revocation-status-list/) — `GET /api/v1/status/{issuerDid}/revocation`
- [Lista de estado (suspensión)](https://sovra-id-docs-1044960690985.us-central1.run.app/api/get-suspension-status-list/) — `GET /api/v1/status/{issuerDid}/suspension`


Source: https://sovra-id-docs-1044960690985.us-central1.run.app/api/index.md
