Individual account holder

GET /account_holders/{accountHolderId}

Path parameters

accountHolderId string Required

Responses

200

OK
Hide response attributes Show response attributes object
- id string(uuid)
- external_id string
  
  Unique ID used to track users in external system
- firstName string
- lastName string
- email string
- phone_number string
- country string
  
  Format should match the following pattern: ^[A-Z]{2}$.
- metadata object
- orders array[object]
  
  Hide orders attributes Show orders attributes array[object]
  
  id string(uuid)
  
  account holder_id string(uuid)
  
  asset_id string(uuid)
  
  subscription_amount number(float)
  
  subscription_currency string
  
  subscribed_at string(date-time)
  
  allocated_amount number(float)
  
  allocated_at string(date-time)
  
  status string
401

Unauthorized

GET /account_holders/{accountHolderId}

curl \
 -X GET https://assets.demo.bitbond.net/api/v1/account_holders/{accountHolderId} \
 -H "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "id": "string",
  "external_id": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "phone_number": "string",
  "country": "string",
  "metadata": {},
  "orders": [
    {
      "id": "string",
      "account holder_id": "string",
      "asset_id": "string",
      "subscription_amount": 42.0,
      "subscription_currency": "string",
      "subscribed_at": "2023-05-04T09:42:00+00:00",
      "allocated_amount": 42.0,
      "allocated_at": "2023-05-04T09:42:00+00:00",
      "status": "string"
    }
  ]
}

Response examples (200)

{
  "id": "string",
  "external_id": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "phone_number": "string",
  "country": "string",
  "metadata": {},
  "orders": [
    {
      "id": "string",
      "account holder_id": "string",
      "asset_id": "string",
      "subscription_amount": 42.0,
      "subscription_currency": "string",
      "subscribed_at": "2025-05-04T09:42:00Z",
      "allocated_amount": 42.0,
      "allocated_at": "2025-05-04T09:42:00Z",
      "status": "string"
    }
  ]
}