Listar bancos
Lista, en orden canónico, todos los bancos que acepta el descubrimiento de llaves.
Envía q para buscar por nombre o alias. La búsqueda tolera tildes,
puntuación, nombres parciales y errores tipográficos, y separa una coincidencia
confiable de una sugerencia:
matchcontiene un único banco ydataestá vacío cuando la consulta coincide exactamente con un código ACH, nombre canónico o alias. Este es el único resultado que puedes usar sin pedir al ordenante que elija.matchesnullydatacontiene sugerencias ordenadas cuando la consulta solo coincide por prefijo o similitud, aunque haya una sola. Muéstralas y deja que el ordenante elija.- Una búsqueda sin resultados responde
200conmatch: nullydatavacío.
En todos los casos, envía a discovery el ach_code canónico del banco
seleccionado.
AutorizaciónBearer <token>
En: header
Scope: target_discoveries
Parámetros de consulta
q?string
Bank name, alias or ACH code to search for.
Length
1 <= lengthlimit?integer
Maximum number of search results. Only applies together with q.
Default
5Range
1 <= value <= 20Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://breb-participant.sandbox.mono.la/api/v1/banks"{
"catalog_version": 1,
"data": [
{
"ach_code": "007",
"name": "BANCOLOMBIA"
}
],
"match": {
"ach_code": "007",
"name": "BANCOLOMBIA"
}
}{
"code": "401 Unauthorized",
"errors": [
{
"error_code": "missing_authorization_header",
"message": "`Authorization` header is missing.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Authorization header is missing or invalid."
}{
"code": "403 Forbidden",
"errors": [
{
"error_code": "not_authorized",
"message": "Not authorized to have access to this resource.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Not authorized to have access to this resource"
}{
"code": "422 Unprocessable Content",
"errors": [
{
"error_code": "missing_field",
"message": "The field is missing on the request body or parameters.",
"path": "#/path/to/field",
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Validation errors"
}{
"code": "429 Too Many Requests",
"errors": [
{
"error_code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the indicated time.",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Too many requests"
}{
"code": "500 Internal Server Error",
"errors": [
{
"error_code": "internal_error",
"message": "An unexpected error occurred",
"path": null,
"url": null
}
],
"id": "log_7MkWaFqvfosB8fzHhb1Eql",
"message": "Something went wrong on the Server"
}