Mono Colombia
GuidesAPI reference

List banks

Lists every bank target discovery accepts, in canonical order.

Pass q to search by name or alias. The search tolerates accents, punctuation, partial names and typos, and it separates confidence from suggestion:

  • match is a single bank and data is empty when the query matched an ACH code, a canonical name or an alias exactly. This is the only result you may use without asking the payer to choose.
  • match is null and data carries ordered suggestions when the query only matched by prefix or similarity — even if there is exactly one. Show them and let the payer pick.
  • A search with no results is a 200 with match: null and an empty data.

Either way, what you send to discovery is the canonical ach_code of the bank that was selected.

GET
/api/v1/banks

Authorization

AuthorizationBearer <token>

In: header

Scope: target_discoveries

Query Parameters

q?string

Bank name, alias or ACH code to search for.

Length1 <= length
limit?integer

Maximum number of search results. Only applies together with q.

Default5
Range1 <= value <= 20

Response Body

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"
}