Skip to main content
GET
/
v1
/
customers
/
{customer_id}
/
accounts
List Accounts
curl --request GET \
  --url https://api.hopnow.io/v1/customers/{customer_id}/accounts \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "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>"
    }
  ],
  "page": 123,
  "size": 123,
  "total": 123,
  "pages": 123
}

​
Path Parameters

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

​
Query Parameters

​
page
integer
default:"1"
Page number (minimum 1)
​
size
integer
default:"10"
Items per page (1-100)
​
statuses
array
Filter accounts by status (e.g., active, suspended)
​
start_date
string
Filter accounts created on or after this date (ISO 8601 format)
​
end_date
string
Filter accounts created before this date (ISO 8601 format)

​
Response

​
items
array
Array of account objects
​
page
integer
Current page number
​
size
integer
Number of items per page
​
total
integer
Total number of items
​
pages
integer
Total number of pages

​
Response Example

{
  "items": [
    {
      "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"
        }
      ],
      "created": "2024-01-01T00:00:00Z"
    },
    {
      "id": "acc_fedcba0987654321",
      "object": "account",
      "customer_id": "cus_abc123",
      "name": "Savings Account",
      "status": "active",
      "balances": [],
      "created": "2024-01-02T00:00:00Z"
    }
  ],
  "page": 1,
  "size": 10,
  "total": 25,
  "pages": 3
}