Assets API

Create new account holder profile

POST /account_holders

Body

  • external_id string

    ID used in external system to track unique users

  • firstName string
  • lastName string
  • email string
  • phone_number string
  • country string

    Format should match the following pattern: ^[A-Z]{2}$.

  • metadata object

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

  • 422

    Failed validation

POST /account_holders 
curl \
 -X POST https://assets.demo.bitbond.net/api/v1/account_holders \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"external_id":"string","firstName":"string","lastName":"string","email":"string","phone_number":"string","country":"string","metadata":{}}'
Request example 
{
  "external_id": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "phone_number": "string",
  "country": "string",
  "metadata": {}
}
Request examples 
{
  "external_id": "string",
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "phone_number": "string",
  "country": "string",
  "metadata": {}
}
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"
    }
  ]
}