List Connections

GET/users/{user_id}/connections

All connections for a user, optionally filtered by type.

Path Parameters

user_idstringrequired

The Sail user id.

Query Parameters

typestring

Filter to connections of one type.

statusstring

Filter to connections in one status.

limitinteger

Max results per page.

offsetinteger

Pagination offset.

Response

The user’s connections.

dataobject[]

Show data properties

idstring

The Sail connection id.

user_idstring

The Sail user this connection belongs to.

type"card" | "store" | "benefit_account" | "external"

The kind of data source this connection links to.

status"active" | "aggregating" | "user_input_required" | "error" | "disconnected"

The connection’s current sync/authentication status.

products"expenses" | "benefit_account" | "account_numbers" | "identity"[]

Capabilities enabled on this connection.

accountsobject[]

Embedded summaries of the accounts under this connection, so account ids are discoverable without a second call. Populated for benefit_account connections (a single administrator login can hold multiple benefit accounts, e.g. HSA + LPFSA); empty for connection types whose accounts are not exposed. Full detail — balances, numbers, contributions — lives at /users/{user_id}/accounts/{account_id}.

Show accounts properties

idstring

The Sail account id.

The account type.

namestring

The account’s display name.

providerobject

The external party this connection links to.

Show provider properties

idstring

The provider’s identifier in Sail’s directory (merchant or administrator id).

namestring

The provider’s display name.

kind"administrator" | "financial_institution" | "merchant" | "external"

What kind of external party this provider is.

icon_urlstring

URL of the provider’s icon/logo.

errorobject

Present when the connection is in an error state. Null otherwise.

Show error properties

codestring

Machine-readable error code.

messagestring

Human-readable error message.

recoverableboolean

Whether the user can resolve this error via a reconnect hosted session.

last_sync_atstring<date-time>

When this connection last completed a sync. Null if it has never synced.

created_atstring<date-time>

When the connection was created.

updated_atstring<date-time>

When the connection was last updated.

paginationobject

Pagination metadata for this page.

Show pagination properties

totalinteger

Total number of matching records, across all pages.

limitinteger

The limit used for this page.

offsetinteger

The offset used for this page.

has_moreboolean

Whether additional pages remain after this one.

Standard error envelope covering 400, 401, 403, 404, 429, and 500.

errorobject

The error detail.

Show error properties

codestring

Machine-readable code, e.g. not_found, token_scope_mismatch, product_not_enabled, insufficient_key_scope, insufficient_token_scope, user_token_required, user_token_expired, invalid_user_token, invalid_key_configuration, connection_not_reconnectable, rate_limited.

messagestring

Human-readable error message. May change, so match on error.code instead.

paramstring

The request field that caused the error, when applicable. Null otherwise.

const response = await fetch(`https://live.savewithsail.com/api/v1/users/${user_id}/connections`, { method: 'GET', headers: { 'Authorization': 'Bearer <token>' } }); const data = await response.json();

import requests response = requests.request( "GET", "https://live.savewithsail.com/api/v1/users/{user_id}/connections", headers={ "Authorization": "Bearer <token>" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://live.savewithsail.com/api/v1/users/<user_id>/connections"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer <token>"]); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "https://live.savewithsail.com/api/v1/users/<user_id>/connections", nil) req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://live.savewithsail.com/api/v1/users/<user_id>/connections")) .header("Authorization", "Bearer <token>") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://live.savewithsail.com/api/v1/users/<user_id>/connections") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer <token>" response = http.request(request) puts response.body

{ "data": [ { "id": "conn_9f2c", "user_id": "string", "type": "card", "status": "active", "products": [ "expenses" ], "accounts": [ { "id": "acct_77b1", "type": "hsa", "name": "HealthEquity HSA" } ], "provider": { "id": "string", "name": "HealthEquity", "kind": "administrator", "icon_url": "string" }, "error": { "code": "INVALID_CREDENTIALS", "message": "string", "recoverable": true }, "last_sync_at": "1970-01-01T00:00:00.000Z", "created_at": "1970-01-01T00:00:00.000Z", "updated_at": "1970-01-01T00:00:00.000Z" } ], "pagination": { "total": 0, "limit": 0, "offset": 0, "has_more": true } }