List all connections

This operation will return every connection status for those that had theirpublicTokens already exchanged. You can pass an externalId (more about it in Link parameters) as a parameter to get those connections associated to it.

List connections for the current app

get

Retrieve every connection status for the connections in the current app

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

externalIdstringOptional

The external ID of the connections you want to fetch

Responses

200

Successfully retrieved all connections for the app

application/json

401

Invalid credentials

application/json

500

Internal server error

application/json

get

/api/v1/queries/connections

HTTPcURLJavaScriptPython

GET /api/v1/queries/connections HTTP/1.1
Host: api.finlink.vumi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "credentialsToken": "AAAAA11111",
    "status": "PENDING",
    "errorDetails": {
      "reason": "INTERNAL_SERVER_ERROR",
      "type": "VUMI_ERROR",
      "retryable": true
    },
    "entity": "santander",
    "createdAt": "2025-12-15T21:28:28.113Z",
    "updatedAt": "2025-12-15T21:28:28.113Z",
    "lastSync": "2025-12-15T21:28:28.113Z",
    "updateToken": "123e4567-e89b-12d3-a456-426614174000",
    "restoreToken": "123e4567-e89b-12d3-a456-426614174000",
    "twoFactorEnabled": true,
    "hasCredentials": true,
    "externalId": "customer-123"
  }
]