Listar Llaves
Visión General
Este endpoint permite recuperar una lista de todas las Llaves Bre-B asociadas a tus clientes dentro de la API de Passport. La respuesta incluye el valor de la llave, tipo, estado y detalles de la entidad asociada.
Detalles del Endpoint
Parámetro | Descripción |
---|---|
Endpoint | https://api.paas.sandbox.co.passportfintech.com/v1/keys |
Método | GET |
Encabezados | Content-Type: application/json, Authorization |
Autenticación | Access Token (Bearer Token) |
Cuerpo de la Solicitud
- No se requiere cuerpo en la solicitud para este endpoint.
Ejemplo de Solicitud
2
2
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/keys' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Cuerpo de la Respuesta
- Código HTTP: 200 OK.
- La respuesta contendrá la lista de llaves, junto con sus identificadores únicos y detalles.
Ejemplo de Respuesta
21
21
{
"keys": [
{
"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"
}
],
"pagination_info": {
"first_request_timestamp": "2025-10-09T18:02:18.706Z",
"current_page": 1,
"total_pages": 1,
"total_elements": 1
}
}
Errores comunes y Manejo
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 listar las Llaves. |
500 Internal Server Error | Error del Servidor | La solicitud no está autorizada para listar las Llaves. |