Account Information

Get account detail

Returns account detail known to SnapTrade for the specified account.

Check your API key on the Customer Dashboard billing page to see if you have real-time data access:

If you do, this endpoint returns real-time data.
If you don't, Daily data is cached and refreshed once a day. Exact refresh timing may vary by brokerage. If you need real-time, use the manual refresh endpoint.

If the connection has become disabled, it can no longer access the latest data from the brokerage, but will continue to return the last available cached state. Please see this guide on how to fix a disabled connection.

get/accounts/{accountId}

Path parameters

accountIdstring uuid required

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

Example:917c8734-8470-4a3e-a18f-57c3f2ee6631

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

idstring uuid required

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

brokerage_authorizationstring uuid required

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

namestring nullable required

A display name for the account. Either assigned by the user or by the brokerage itself. For certain brokerages, SnapTrade appends the brokerage name to the account name for clarity.

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_namestring required

The name of the brokerage that holds the account.

created_datestring date-time required

Timestamp in ISO 8601 format indicating when the account was created in SnapTrade. This is not the account opening date at the brokerage.

funding_datestring date-time nullable

Timestamp in ISO 8601 format indicating when the account was funded. Only populated for brokerages that expose this data (Tastytrade, eToro, moomoo, Public, and Unlok); null for all other brokerages.

opening_datestring date-time nullable

Timestamp in ISO 8601 format indicating when the account was opened at the brokerage. Only populated for brokerages that expose this data (Tastytrade, eToro, moomoo, Public, and Unlok); null for all other brokerages.

status'open' | 'closed' | 'archived' | 'unavailable' nullable

The current status of the account. Can be either "open", "closed", "archived" or null if the status is unknown or not provided by the brokerage.

raw_typestring nullable

The account type as provided by the brokerage

account_category'INVESTMENT' | 'DEPOSIT' | 'LOC' nullable

The category of the account, normalized across institutions. Returns null if the category could not be determined. Use this field to filter out non-investment accounts if your integration only supports trading / holdings flows. See Filtering Accounts by Category for more information.

INVESTMENT: A brokerage / investment account (equities, options, crypto, etc.).
DEPOSIT: A bank deposit account (checking, savings).
LOC: A line of credit account.

metaobject

Additional information about the account, such as account type, status, etc. This information is specific to the brokerage and there's no standard format for this data. This field is deprecated and subject to removal in a future version.

portfolio_groupstring uuid nullable

Portfolio Group ID. Portfolio Groups have been deprecated. Please contact support if you have a use case for it.

cash_restrictionsstring[]

This field is deprecated.

is_paperboolean required

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

Example response

{
  "id": "917c8734-8470-4a3e-a18f-57c3f2ee6631",
  "brokerage_authorization": "87b24961-b51e-4db8-9226-f198f6518a89",
  "name": "Robinhood Individual",
  "number": "Q6542138443",
  "institution_account_id": "54953432",
  "institution_name": "Robinhood",
  "created_date": "2024-07-23T22:50:22.761390Z",
  "funding_date": "2024-07-25T12:00:00.000000Z",
  "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"
    },
    "holdings": {
      "initial_sync_completed": true,
      "last_successful_sync": "2024-06-28 18:42:46.561408+00:00",
      "holdings_unavailable": true
    }
  },
  "balance": {
    "total": {
      "amount": 15363.23,
      "currency": "USD"
    }
  },
  "status": "open",
  "raw_type": "Margin",
  "account_category": "INVESTMENT",
  "meta": {
    "type": "Margin",
    "status": "ACTIVE",
    "institution_name": "Robinhood"
  },
  "portfolio_group": "2bcd7cc3-e922-4976-bce1-9858296801c3",
  "cash_restrictions": []
}

Changes

Changed in 4 of the 65 revisions of this API.112

Jul 27, 2026aba0f7be46cf1See the full diff
- ○
  added the optional property sync_status/holdings/holdings_unavailable to the response with the 200 status
  response-optional-property-added
May 13, 20266eb1704033421See the full diff
- ▲
  the response property portfolio_group became nullable for the status 200
  response-property-became-nullable
Apr 24, 2026459cf795c96c1See the full diff
- ○
  added the optional property account_category to the response with the 200 status
  response-optional-property-added
Mar 6, 20266a3b37154f491See the full diff
- ●
  removed the optional property account_category from the response with the 200 status
  response-optional-property-removed
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history