Sign in

v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0776187299.9 KB
Experimental endpoints

List accounts for a connection (discriminated union)

Experimental and subject to change without notice.

Returns the accounts that belong to the specified connection for the authenticated user, using the kind-discriminated account shape.

Each item in the response carries a kind field (currently only investment is implemented) that determines which additional fields are present -- see the ConnectionAccount schema.

On Pay as you Go / Real-time, this endpoint refreshes each account's opening date, funding date, and market value live from the brokerage on each call.

On Pay as you Go / Daily, this endpoint returns Daily data. Daily data is cached and refreshed once a day. Exact refresh timing may vary by brokerage. To force a refresh, use the manual refresh endpoint.

Check your API key on the Customer Dashboard billing page to see whether your plan includes real-time data.

get/connections/{authorizationId}/accounts

Path parameters

authorizationIdstring uuid required

Unique identifier for the connection (brokerage_authorization_id). This is the UUID used to reference the connection in SnapTrade.

Example:87b24961-b51e-4db8-9226-f198f6518a89

Query parameters

userIdstring required

SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.

Example:snaptrade-user-123
userSecretstring required

SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the rotate user secret endpoint.

Example:adf2aa34-8219-40f7-a6b3-60156985cc61

Response

OK

kind'investment' required

Discriminator for the account kind.

idstring uuid required

Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

connection_idstring uuid required

Unique identifier for the connection (brokerage_authorization_id). This is the UUID used to reference the connection in SnapTrade.

display_namestring nullable

A display name for the account. Either assigned by the user or by the brokerage itself.

numberstring required

The account number assigned by the brokerage. For some brokerages, this field may be masked for security reasons.

institution_account_idstring nullable

A stable and unique account identifier provided by the institution. Will be set to null if not provided. When present, can be used to check if a user has connected the same brokerage account across multiple connections.

institution_idstring uuid

Unique identifier for the institution (brokerage) that holds the account.

opening_datestring date-time nullable

Timestamp in ISO 8601 format indicating when the account was opened at the brokerage.

raw_typestring nullable

The account type as provided by the brokerage.

funding_datestring date-time nullable

Timestamp in ISO 8601 format indicating when the account was funded.

is_paperboolean required

Indicates whether the account is a paper (simulated) trading account.

Example response

[
  {
    "kind": "investment",
    "id": "917c8734-8470-4a3e-a18f-57c3f2ee6631",
    "connection_id": "87b24961-b51e-4db8-9226-f198f6518a89",
    "display_name": "Robinhood Individual",
    "number": "Q6542138443",
    "institution_account_id": "54953432",
    "institution_id": "b6e1a9f0-6e2a-4c37-9b0a-6f1e2d3c4b5a",
    "opening_date": "2024-07-20T09:30:00.000000Z",
    "sync_status": {
      "transactions": {
        "initial_sync_completed": true,
        "last_successful_sync": "2022-01-24",
        "first_transaction_date": "2022-01-24"
      },
      "orders": "2024-06-28 18:42:46.561408+00:00",
      "positions": "2024-06-28 18:42:46.561408+00:00",
      "balances": "2024-06-28 18:42:46.561408+00:00"
    },
    "raw_type": "Margin",
    "funding_date": "2024-07-25T12:00:00.000000Z",
    "market_value": {
      "amount": 84213.55,
      "currency": "USD"
    }
  }
]