Sail

List HSA/FSA Administrators

GET/administrators

Directory of supported administrators for benefit_account connections.

Query Parameters

searchstring

Fuzzy search by administrator name.

limitinteger

Max results per page.

offsetinteger

Pagination offset.

Response

Administrators.

dataobject[]
Show data properties
idstring

The Sail administrator id.

namestring

The administrator’s display name.

capabilitiesobject

What Sail can do for this administrator.

Show capabilities properties
supports_rpaboolean

Whether Sail connects to this administrator via automated login (RPA) rather than a direct API integration.

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

Products this administrator can supply data for.

urlsobject

Public URLs associated with this administrator.

Show urls properties
mainstring

The administrator’s main website URL.

logostring

URL of the administrator’s logo. Null if unavailable.

forgot_passwordstring

URL of the administrator’s password-recovery page.

forgot_usernamestring

URL of the administrator’s username-recovery page.

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.

Request
curl -X GET "https://live.savewithsail.com/api/v1/administrators?search=<search>&limit=<limit>&offset=<offset>" \
  -H "Authorization: Bearer <token>"
Response
{
  "data": [
    {
      "id": "string",
      "name": "string",
      "capabilities": {
        "supports_rpa": true,
        "products": [
          "expenses"
        ]
      },
      "urls": {
        "main": "string",
        "logo": "string",
        "forgot_password": "string",
        "forgot_username": "string"
      }
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "has_more": true
  }
}