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

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

GEThttps://api.finlink.vumi.io/api/v1/queries/connections/pending

Authorization

bearerAuth

Query parameters

Response

200401500

Successfully retrieved all public tokens for the app

Body

application/json

publicTokenstring (uuid)

UUID unique token used to retrieve connection token

Example: "567578d1-4411-4a2f-9b67-00c06536565a"

externalIdstring

External ID that can be indicated to group multiple connections under the same identifier

Example: "TEST"

createdAtstring (date-time)

Timestamp in UTC at which the connection was created

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.finlink.vumi.io/api/v1/queries/connections/pending', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200

[
  {
    "publicToken": "567578d1-4411-4a2f-9b67-00c06536565a",
    "externalId": "TEST",
    "createdAt": "2025-02-05T07:36:31.134Z"
  }
]