Consultar Llave

Visión General

Este endpoint permite recuperar los detalles de una Llave Bre-B específica en la API de Passport usando el ID de la llave. La respuesta incluye el valor de la llave, tipo, estado y los detalles de la entidad asociada.

Detalles del Endpoint

Definition	Description
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/keys/:key_id
Method	GET
Headers	Content-Type: application/json, Authorization
Authentication	Access Token (Bearer Token)

Cuerpo de la Solicitud

No se requiere cuerpo en la solicitud para este endpoint.

Ejemplo de Solicitud

JSON
    
xxxxxxxxxx
 
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/keys/3184cbfd-73bd-4910-bd03-f8461e724247' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK
La respuesta contiene los detalles de la llave junto con su identificador único.

Ejemplo de Respuesta

JSON
    
xxxxxxxxxx
 
{
    "status": "ACTIVE",
    "key": {
        "key_type": "BCODE",
        "key_value": "0016027228"
    },
    "account_id": "6c23f053-0e1a-46b4-b902-97ba47e351bc",
    "created_at": "2025-10-09T10:42:39.710Z",
    "updated_at": "2025-10-09T10:42:39.710Z",
    "id": "3184cbfd-73bd-4910-bd03-f8461e724247"
}
Copy

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400 Bad Request	Datos inválidos	Faltan campos requeridos o contienen valores incorrectos.
401 Unauthorized	Token expirado	El token de acceso es inválido o ha expirado.
403 Forbidden	Acceso denegado	La solicitud no está autorizada para recuperar una Llave.
500 Internal Server Error	Error del servidor	Ocurrió un error inesperado al recuperar la Llave

Última actualización el