# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/customers/cus_x7k2m9p4q1w8e5r3t6y0u2i4/accounts?page=1&size=10" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"items": [
{
"object": "account",
"id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"customer_id": "cus_x7k2m9p4q1w8e5r3t6y0u2i4",
"type": "business",
"kyc_status": "under_review",
"display_name": "Acme GmbH",
"contact_email": "ops@acme.example",
"country_code": "DE",
"rejection_reasons": null,
"created": "2026-05-01T10:00:00Z",
"updated": "2026-05-02T08:30:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}
Accounts
List Accounts
List the accounts the Platform customer has onboarded
GET
/
va
/
v1
/
customers
/
{customer_id}
/
accounts
# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/customers/cus_x7k2m9p4q1w8e5r3t6y0u2i4/accounts?page=1&size=10" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"items": [
{
"object": "account",
"id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"customer_id": "cus_x7k2m9p4q1w8e5r3t6y0u2i4",
"type": "business",
"kyc_status": "under_review",
"display_name": "Acme GmbH",
"contact_email": "ops@acme.example",
"country_code": "DE",
"rejection_reasons": null,
"created": "2026-05-01T10:00:00Z",
"updated": "2026-05-02T08:30:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}
Returns a paginated list of accounts the Platform customer has onboarded.
Path Parameters
string
required
Platform customer id.
Query Parameters
integer
default:"1"
Page number. Default 1; must be ≥ 1.
integer
default:"10"
Items per page. Default 10; range 1–100.
string[] | null
Filter by account status (e.g.
active, suspended).datetime | null
Only accounts created on or after this timestamp (inclusive).
datetime | null
Only accounts created before this timestamp (exclusive).
Response
Returns a paginated list envelope of account objects.object[]
The account objects on this page.
Show account attributes
Show account attributes
string
Always
account.string
Account id (e.g.
acct_3mnq7c1e6a2b4f3c9b8d2e5a).string
Platform customer id.
enum | null
Entity type:
individual or business. null until KYC starts.enum | null
Verification status:
not_started, under_review, action_needed, approved, or rejected.string | null
Account display name.
string | null
Primary contact email.
string | null
ISO 3166-1 alpha-2 country code. Derived from
registered_address.country.object[] | null
Review rejection reasons, populated only when
kyc_status is rejected; each entry has a user-safe reason and a developer_reason for your integration logic. Null otherwise.string
ISO 8601 timestamp when created.
string
ISO 8601 timestamp when last updated.
string | null
Actor that created the account.
string | null
Actor that last updated the account.
integer
Current page number.
integer
Items per page.
integer
Total number of items.
integer
Total number of pages.
# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/customers/cus_x7k2m9p4q1w8e5r3t6y0u2i4/accounts?page=1&size=10" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"items": [
{
"object": "account",
"id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"customer_id": "cus_x7k2m9p4q1w8e5r3t6y0u2i4",
"type": "business",
"kyc_status": "under_review",
"display_name": "Acme GmbH",
"contact_email": "ops@acme.example",
"country_code": "DE",
"rejection_reasons": null,
"created": "2026-05-01T10:00:00Z",
"updated": "2026-05-02T08:30:00Z",
"created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
"updated_by": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}