List public tokens

This endpoint will return every publicToken that has not been exchanged. Public tokens can only be exchanged once, and a connection is not available for you in other endpoints until you exchange its publicToken. You can indicate the externalId to retrieve only tokens for that external id.

List of public tokens pending to convert

get

Retrieve every public token still not converted to a connection token for the current app

Authorizations

Query parameters

externalIdstringOptional

The external ID of the connections you want to fetch

Responses

200

Successfully retrieved all public tokens for the app

application/json

401

Invalid credentials

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

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

[
  {
    "publicToken": "567578d1-4411-4a2f-9b67-00c06536565a",
    "externalId": "TEST",
    "createdAt": "2025-05-16T08:24:27.541Z"
  }
]