Skip to main content
GET
/
v1
/
customers
/
{customer_id}
/
accounts
/
{account_id}
Get Account
curl --request GET \
  --url https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "customer_id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "balances": [
    {
      "currency": "<string>",
      "currency_type": "<string>",
      "available_balance": "<string>",
      "pending_payout": "<string>",
      "pending_payin": "<string>",
      "total_balance": "<string>",
      "updated_at": "<string>"
    }
  ],
  "created": "<string>",
  "updated": "<string>"
}

​
Path Parameters

​
customer_id
string
required
The customer’s external ID (starts with cus_)
​
account_id
string
required
The account’s external ID (starts with acc_)

​
Response

​
id
string
Account identifier (starts with acc_)
​
object
string
Always returns "account"
​
customer_id
string
The customer’s external ID
​
name
string
The account name
​
status
string
Account status: active, suspended, or inactive
​
balances
array
Array of balance objects for each currency
​
created
string
ISO 8601 timestamp when the account was created
​
updated
string
ISO 8601 timestamp when the account was last updated

​
Response Example

{
  "id": "acc_1234567890abcdef",
  "object": "account",
  "customer_id": "cus_abc123",
  "name": "Primary Trading Account",
  "status": "active",
  "balances": [
    {
      "currency": "USD",
      "currency_type": "fiat",
      "available_balance": "10000.50",
      "pending_payout": "250.00",
      "pending_payin": "500.00",
      "total_balance": "10750.50",
      "updated_at": "2024-01-15T12:30:00Z"
    },
    {
      "currency": "EUR",
      "currency_type": "fiat",
      "available_balance": "5000.25",
      "pending_payout": "0.00",
      "pending_payin": "100.00",
      "total_balance": "5100.25",
      "updated_at": "2024-01-14T08:00:00Z"
    }
  ],
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-15T12:30:00Z"
}