Skip to main content
GET
/
v1
/
accounts
/
{accountId}
cURL
curl --request GET \
  --url https://api.nxos.io/v1/accounts/{accountId} \
  --header 'Authorization: <authorization>'
{
  "object": "account",
  "accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "Main",
  "description": null,
  "isPrimary": true,
  "status": "ACTIVE",
  "fundingMethods": [],
  "balances": [
    {
      "object": "balance",
      "asset": "USD",
      "amount": "15000.00"
    },
    {
      "object": "balance",
      "asset": "USDC",
      "amount": "5000.000000"
    }
  ],
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:30:00.000Z"
}

Headers

​
Authorization
string
required

Bearer token. Format: Bearer <api_key>

Path Parameters

​
accountId
string
required

Response

The request has succeeded.

Detailed view of a financial account, including balances and funding methods.

​
object
enum<string>
required

Object type. Always account.

Available options:
account
​
accountId
string
required

Unique account identifier.

​
name
string | null
required

Display name for the account.

​
description
string | null
required

Optional description of the account's purpose.

​
isPrimary
boolean
required

Whether this is the organization's primary account.

​
status
enum<string>
required

Current account status.

Available options:
ACTIVE,
SUSPENDED,
CLOSED
​
fundingMethods
object[]
required

Funding methods attached to this account.

​
balances
object[]
required

Current balances per asset held in this account.

​
createdAt
string
required

When the account was created.

​
updatedAt
string
required

When the account was last updated.