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

get

/api/v1/queries/connections/pending

Authorizations

Query parameters

externalIdstring

The external ID of the connections you want to fetch

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.finlink.vumi.io/api/v1/queries/connections/pending' \
  --header 'Authorization: Bearer JWT'

200

401

500

200

[
  {
    "publicToken": "567578d1-4411-4a2f-9b67-00c06536565a",
    "externalId": "TEST",
    "createdAt": "2025-03-12T03:52:06.563Z"
  }
]

Successfully retrieved all public tokens for the app