Skip to main content
GET
/
api
/
v1
/
partner
/
accounts
List customer accounts
curl --request GET \
  --url https://api.vobiz.ai/api/v1/partner/accounts \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
{
  "accounts": [
    {
      "name": "Acme Corp",
      "email": "admin@acme-corp.com",
      "phone": "+919876543210",
      "description": null,
      "gstin": null,
      "gst_status": null,
      "tds_enabled": false,
      "tds_percentage": 2,
      "business_type": "individual",
      "id": "500000",
      "auth_id": "MA_XXXXXXXX",
      "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "account_type": "standard",
      "role": "user",
      "postpaid": false,
      "address": "221B Baker Street",
      "city": "Mumbai",
      "state": null,
      "timezone": "Asia/Kolkata",
      "country": "IN",
      "zip_code": "400001",
      "company": "Acme Corp",
      "billing_mode": "prepaid",
      "auto_recharge": false,
      "cash_credits": "1300.00000",
      "cps_limit": 1,
      "concurrent_calls_limit": 4,
      "base_cps_limit": null,
      "base_concurrent_calls_limit": null,
      "purchased_cps": null,
      "purchased_concurrent_calls": null,
      "is_active": true,
      "is_verified": false,
      "is_trial_account": false,
      "enabled": true,
      "kyc_status": "pending",
      "google_id": null,
      "referral_code": null,
      "referral_disabled": false,
      "custom_referrer_reward_amount": null,
      "custom_referee_reward_amount": null,
      "created_at": "2026-03-25T10:00:00Z",
      "updated_at": "2026-03-26T11:54:13Z",
      "last_login": "2026-03-25T10:16:47Z",
      "pricing_tier_id": "11223344-1234-5678-90ab-cdef12345678",
      "pricing_tier": {
        "id": "11223344-1234-5678-90ab-cdef12345678",
        "name": "Standard",
        "currency": "INR",
        "rate_per_minute": 0.45,
        "streaming_rate_per_minute": 0.2,
        "recording_rate_per_minute": 0.1,
        "whatsapp_voice_rate": 0.45,
        "transcription_rate_per_minute": 0.1,
        "pii_redaction_rate_per_minute": 0.3,
        "charge_non_connected_calls": true,
        "non_connected_call_fee": 0.02,
        "did_release_fee": 700,
        "is_active": true,
        "is_default": false,
        "partner_id": null
      },
      "partner_id": "99887766-1234-5678-90ab-cdef12345678",
      "auto_recharge_config": null,
      "resource_uri": "/v1/Account/MA_XXXXXXXX/",
      "auth_token": "<redacted>"
    },
    {
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "+918012345678",
      "description": null,
      "gstin": null,
      "gst_status": null,
      "tds_enabled": false,
      "tds_percentage": 2,
      "business_type": "individual",
      "id": "500001",
      "auth_id": "MA_YYYYYYYY",
      "api_id": "55667788-1234-5678-90ab-cdef12345678",
      "account_type": "standard",
      "role": "user",
      "postpaid": false,
      "address": null,
      "city": null,
      "state": null,
      "timezone": null,
      "country": "IN",
      "zip_code": null,
      "company": "Acme Corp",
      "billing_mode": "prepaid",
      "auto_recharge": false,
      "cash_credits": "1107.00000",
      "cps_limit": 1,
      "concurrent_calls_limit": 3,
      "base_cps_limit": null,
      "base_concurrent_calls_limit": null,
      "purchased_cps": null,
      "purchased_concurrent_calls": null,
      "is_active": true,
      "is_verified": false,
      "is_trial_account": false,
      "enabled": true,
      "kyc_status": "pending",
      "google_id": null,
      "referral_code": null,
      "referral_disabled": false,
      "custom_referrer_reward_amount": null,
      "custom_referee_reward_amount": null,
      "created_at": "2026-03-20T05:58:46Z",
      "updated_at": "2026-03-21T05:13:16Z",
      "last_login": null,
      "pricing_tier_id": "11223344-1234-5678-90ab-cdef12345678",
      "pricing_tier": {
        "id": "11223344-1234-5678-90ab-cdef12345678",
        "name": "Standard",
        "currency": "INR",
        "rate_per_minute": 0.45,
        "streaming_rate_per_minute": 0.2,
        "recording_rate_per_minute": 0.1,
        "whatsapp_voice_rate": 0.45,
        "transcription_rate_per_minute": 0.1,
        "pii_redaction_rate_per_minute": 0.3,
        "charge_non_connected_calls": true,
        "non_connected_call_fee": 0.02,
        "did_release_fee": 700,
        "is_active": true,
        "is_default": false,
        "partner_id": null
      },
      "partner_id": "99887766-1234-5678-90ab-cdef12345678",
      "auto_recharge_config": null,
      "resource_uri": "/v1/Account/MA_YYYYYYYY/",
      "auth_token": "<redacted>"
    }
  ],
  "total": 2,
  "page": 1,
  "size": 20
}
← Partner API Reference The core of the Partner API. Provision SIP-enabled sub-accounts for your clients, inspect their profiles, and monitor their real-time wallet balances. Each customer receives an auth_id that serves as the primary key for all subsequent operations.
All Partner API requests use X-Auth-ID and X-Auth-Token headers. See Authentication for details.

​
Overview

MethodEndpointDescription
POST/accountsCreate a new customer sub-account
GET/accountsList all customer accounts (paginated)
GET/accounts/{customer_auth_id}Get full profile for a specific customer
GET/accounts/{customer_auth_id}/balanceGet real-time wallet balance for a customer

​
Create Customer Account

Provisions a new SIP-enabled Vobiz account under your partner umbrella. The customer is created instantly and can start receiving calls as soon as you assign a phone number and fund their wallet.

​
Request Body

FieldTypeRequiredDescription
namestringRequiredCustomer’s full name
emailstringRequiredCustomer email - used for login and KYC notifications
passwordstringRequiredCustomer login password (min 8 chars, must include number and special char)
phonestringOptionalE.164 phone number, e.g. +919876543210
descriptionstringOptionalFree-text description of the customer’s use case
companystringOptionalLegal company or business name
addressstringOptionalStreet address
citystringOptionalCity
statestringOptionalState or region
zip_codestringOptionalPostal/ZIP code
countrystringRequiredISO 2-letter country code, e.g. IN
timezonestringOptionalIANA timezone, e.g. Asia/Kolkata
gstinstringOptionalGSTIN for tax invoicing (India)
gst_statusstringOptionalactive or inactive
account_typestringOptionalstandard (default) or other plan tier
The minimum verified field set is name, email, phone, password, and country. company is the only documented optional field guaranteed by the API contract; the remaining optional fields above are accepted on a best-effort basis - if your call rejects one, drop it and set it later via the Console.
Validation rules
  • email must be unique across the whole Vobiz platform - reusing an email returns 422.
  • password must be at least 8 characters and contain a number and a special character. A weaker password returns 422.
  • phone must be E.164 (leading + and country code).
  • country must be a valid ISO 3166-1 alpha-2 code. The customer’s wallet currency is derived from it (IN → INR).
  • Creating a customer counts against your max_accounts limit (see Profile). Exceeding it returns 403.
curl -X POST \
  "https://api.vobiz.ai/api/v1/partner/accounts" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "admin@example.com",
    "password": "<redacted>",
    "phone": "+919876543210",
    "description": "Outbound collections calling team",
    "company": "Acme Corp",
    "address": "1 MG Road",
    "city": "Bengaluru",
    "state": "KA",
    "zip_code": "560001",
    "country": "IN",
    "timezone": "Asia/Kolkata",
    "gstin": "29AAPFU0939F1ZV",
    "gst_status": "active",
    "account_type": "standard"
  }'

​
Response

{
  "auth_id": "MA_XXXXXXXX",
  "auth_token": "<redacted>",
  "name": "John Doe",
  "email": "john@example.com",
  "status": "active",
  "balance": 0.00,
  "currency": "INR",
  "country": "IN",
  "created_at": "2026-03-25T10:00:00Z"
}
A successful create returns 201 Created. The new customer starts with balance: 0.00 and status: active, but kyc_status is pending and the wallet is empty - you must transfer balance and (for India) run KYC before the account is fully usable.
Store both auth_id and auth_token immediately - the auth_token is shown only once. The auth_id is the customer’s permanent identifier for every partner operation (balance transfers, CDR lookups, transaction queries, number assignments). The auth_token is the customer’s own API secret - the only way to retrieve it again later is Get Customer Account. Treat the auth_token like a password: store it encrypted server-side and never expose it in client-side code, URLs, or logs.

​
Errors

StatusCause
401 / 403Missing/invalid partner credentials, or can_create_accounts is false on your partner profile.
403You have hit your max_accounts limit.
409 / 422Email already in use, or a field failed validation (weak password, malformed phone, bad country code).

​
List Customer Accounts

Returns a paginated list of all customer accounts under your partner umbrella. Use search to find a specific customer by name or email.

​
Query Parameters

ParameterDefaultDescription
page1Page number (1-indexed)
per_page20Items per page (max 100)
search-Substring match on customer name or email
The request uses per_page, but the response echoes it back as size. They are the same value under two different keys.
curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts?page=1&per_page=20" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts?page=1&per_page=20&search=Acme" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

{
  "accounts": [
    {
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "+919876543210",
      "description": null,
      "gstin": null,
      "gst_status": null,
      "tds_enabled": false,
      "tds_percentage": 2,
      "business_type": "individual",
      "id": "500000",
      "auth_id": "MA_XXXXXXXX",
      "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "account_type": "standard",
      "role": "user",
      "postpaid": false,
      "address": "1 MG Road",
      "city": "Bengaluru",
      "state": "KA",
      "timezone": "Asia/Kolkata",
      "country": "IN",
      "zip_code": "560001",
      "company": "Acme Corp",
      "billing_mode": "prepaid",
      "auto_recharge": false,
      "cash_credits": "1300.00000",
      "cps_limit": 1,
      "concurrent_calls_limit": 4,
      "base_cps_limit": null,
      "base_concurrent_calls_limit": null,
      "purchased_cps": null,
      "purchased_concurrent_calls": null,
      "is_active": true,
      "is_verified": false,
      "is_trial_account": false,
      "enabled": true,
      "kyc_status": "pending",
      "google_id": null,
      "referral_code": null,
      "referral_disabled": false,
      "custom_referrer_reward_amount": null,
      "custom_referee_reward_amount": null,
      "created_at": "2026-05-06T07:12:40.437143+00:00",
      "updated_at": "2026-05-07T11:54:13.620089+00:00",
      "last_login": "2026-05-06T07:16:47.457817+00:00",
      "pricing_tier_id": "11223344-1234-5678-90ab-cdef12345678",
      "pricing_tier": {
        "id": "11223344-1234-5678-90ab-cdef12345678",
        "name": "Standard",
        "currency": "INR",
        "rate_per_minute": 0.45,
        "streaming_rate_per_minute": 0.2,
        "recording_rate_per_minute": 0.1,
        "whatsapp_voice_rate": 0.45,
        "transcription_rate_per_minute": 0.1,
        "pii_redaction_rate_per_minute": 0.3,
        "charge_non_connected_calls": true,
        "non_connected_call_fee": 0.02,
        "did_release_fee": 700,
        "is_active": true,
        "is_default": false,
        "partner_id": null
      },
      "partner_id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "auto_recharge_config": null,
      "resource_uri": "/v1/Account/MA_XXXXXXXX/",
      "auth_token": "<redacted>"
    }
  ],
  "total": 23,
  "page": 1,
  "size": 20
}

​
Get Customer Account

Returns the full technical profile for a specific customer, including their auth token (required to make API calls on their behalf), billing configuration, GST details, and current status. 
curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+919876543210",
  "description": null,
  "gstin": null,
  "gst_status": null,
  "tds_enabled": false,
  "tds_percentage": 2,
  "business_type": "individual",
  "id": "500000",
  "auth_id": "MA_XXXXXXXX",
  "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "account_type": "standard",
  "role": "user",
  "postpaid": false,
  "address": "1 MG Road",
  "city": "Bengaluru",
  "state": "KA",
  "timezone": "Asia/Kolkata",
  "country": "IN",
  "zip_code": "560001",
  "company": "Acme Corp",
  "billing_mode": "prepaid",
  "auto_recharge": false,
  "cash_credits": "1300.00000",
  "cps_limit": 1,
  "concurrent_calls_limit": 4,
  "is_active": true,
  "is_verified": false,
  "is_trial_account": false,
  "enabled": true,
  "kyc_status": "pending",
  "created_at": "2026-05-06T07:12:40.437143+00:00",
  "updated_at": "2026-05-07T11:54:13.620089+00:00",
  "last_login": "2026-05-06T07:16:47.457817+00:00",
  "pricing_tier_id": "11223344-1234-5678-90ab-cdef12345678",
  "pricing_tier": {
    "id": "11223344-1234-5678-90ab-cdef12345678",
    "name": "Standard",
    "currency": "INR",
    "rate_per_minute": 0.45,
    "is_active": true,
    "is_default": false,
    "partner_id": null
  },
  "partner_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "auto_recharge_config": null,
  "resource_uri": "/v1/Account/MA_XXXXXXXX/",
  "auth_token": "<redacted>"
}

​
Get Customer Balance

Returns the real-time wallet balance for a specific customer. Check this before deciding whether to top up a customer’s wallet. A customer with zero or near-zero balance will start experiencing call failures. 
curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/balance" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

{
  "auth_id": "MA_XXXXXXXX",
  "name": "John Doe",
  "cash_credits": "1300.00000",
  "currency": "INR",
  "updated_at": "2026-05-07T11:54:13.620089+00:00"
}

​
Provisioning Workflow

Follow this sequence when onboarding a new customer:
  • Create the account - Provision the sub-account. Store the returned auth_id in your database.
  • Fund the wallet - Transfer an opening balance from your master account. The customer cannot make calls without balance.
  • Assign phone numbers - Assign one or more DID phone numbers to the customer account. Customers need a DID to receive inbound calls.
  • Monitor usage - Pull CDRs and transaction logs regularly for billing and quality monitoring.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Query Parameters

​
page
integer
default:1
​
per_page
integer
default:20
​
search
string

Substring match on name or email.

Response

200 - application/json

Customer accounts

​
accounts
object[]
required
​
total
integer
required
​
page
integer
required
​
size
integer
required