List All Connections

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor

string

Pagination cursor to start requests from

limit

integer

The maximum number of results to return in a page.

externalId

string

dotNumber

string

tag

string

Filter connections by tag

updatedAfter

string

Filter connections that were last updated on or after a given time.

updatedBefore

string

Filter connections that were last updated on or before a given time.

Response

200 - application/json

results

object[]

required

results.company

object

required

results.createdAt

string

required

ISO 8601 date

results.id

string

required

results.provider

object

required

results.status

enum<string>

required

Enum values:

connected: active and authenticated connection
disconnected: connection is no longer authenticated - please ask your user to link the account again
archived: connection has been archived from view - attempts to re-connect will cause us to check the connection status again

Available options:

connected,

disconnected,

archived,

pending_deletion

results.syncMode

enum<string>

default:

automatic

required

Enum values:

automatic: Terminal will keep this connections data up to date
manual: Terminal will only sync data upon request

Available options:

automatic,

manual

results.token

string

required

This token is used when interacting with a connections' data.

results.updatedAt

string

required

ISO 8601 date

results.externalId

string

An optional ID from your system that can be used to reference connections.

results.linkUrl

string

The URL to send your user to in order to have them re-authenticate the connection.

results.sourceId

string

The ID used in the source system to represent the account this connection has access to.

This may be an organizationId or accountId.

Note: not all systems expose this information, in which case it may be undefined.

results.tags

string[]

An optional list of tags from your system that can be used to reference connections.

string

Cursor used for pagination.