List bank connections

Returns the workspace’s bank connections ordered by name, then id.

One connection is one authorisation with one bank, and it can feed several accounts. Connections delegated from another workspace are included when they feed an account this workspace can see, so every bank on an account resolves here.

Manual accounts have no connection and are not represented.

GET /banks

List bank connections

cURL

curl --request GET \
  --url https://api.thinkout.io/v1/banks \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "list",
  "data": [
    {
      "object": "bank",
      "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "name": "ING Bank",
      "country_code": "RO",
      "status": "connected",
      "last_sync_at": "2026-09-03T06:00:00Z",
      "consent_expires_at": "2026-11-30T00:00:00Z",
      "created_at": "2024-01-01T10:00:00Z",
      "updated_at": "2026-09-03T06:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization · string · header · required

A workspace API key created in ThinkOut settings. One key reads one workspace.

Query Parameters

status · enum<string>

The state of the connection as of ThinkOut's last exchange with the provider.

connected is working. loading is a sync in progress. requires_action needs a person to sign in or re-approve the connection in ThinkOut, and no new transactions arrive until they do. error is a failure ThinkOut could not resolve on its own, and covers any provider state ThinkOut cannot place.

Only connected means the data behind it is current.

Available options: connected, loading, requires_action, error

limit · integer · default: 100

Page size.

Required range: 1 <= x <= 500

cursor · string

Opaque token from the previous page's next_cursor.

Response

200

application/json

A page of bank connections.

object · string · required

Allowed value: "list"

data · object[] · required

Show child attributes

has_more · boolean · required

Whether another page exists.

next_cursor · string | null · required

Pass as cursor to fetch the next page. null on the last page.