Banks

Use these endpoints to see which banks Reconbanker supports and to look up the integration details for a specific bank. Most operators only need the List banks endpoint. New banks are added by the Reconbanker team on request.

All endpoints require Authorization: Bearer <jwt>.

List banks

Use this endpoint to retrieve the catalog of banks you can enroll an account at.

GET /banks

Response 200 OK:

[
  {
    "id": "uuid",
    "code": "itau",
    "name": "Banco Itaú",
    "loginUrl": "https://www.itaulink.com.uy/",
    "status": "active"
  }
]

Register a new bank

Use this endpoint to add a new bank to the catalog. This is typically only used by Reconbanker administrators.

POST /banks
Content-Type: application/json

Request body:

{
  "code": "itau",
  "name": "Banco Itaú",
  "loginUrl": "https://www.itaulink.com.uy/"
}

• code - required, short identifier.
• name - required.
• loginUrl - optional.

Responses:

• 201 Created - { "id": "uuid" }
• 400 Bad Request - { "error": "code and name are required" }

Get one bank

Use this endpoint to inspect a specific bank, including the integration versions Reconbanker has available for it.

GET /banks/:bankId

Response 200 OK:

{
  "id": "uuid",
  "code": "itau",
  "name": "Banco Itaú",
  "loginUrl": "https://www.itaulink.com.uy/",
  "status": "active",
  "scripts": [
    {
      "id": "uuid",
      "flow_type": "extract_transactions",
      "version": "2.0.1",
      "status": "active",
      "origin": "manual",
      "created_at": "2026-04-01T12:00:00Z"
    }
  ]
}

Responses:

• 200 OK
• 404 Not Found - { "error": "Bank not found" }