Billing

Update billing account

Updates the billing account information for the given ID.

put/billing_accounts/{id}

Request

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/billing_accounts/{id}
  • Auth
    none declared

Path parameters

idstring required

The ID of the billing account.

Request body

namestring
detailstring

Response

Successfully updated billing account

idstring uuid

The unique identifier of the account.

customer_idstring uuid

The unique identifier of the associated customer. Returned from the GET /customers response.

status'active' | 'frozen' | 'deleted'

The status of the billing account.

namestring

The display name of the billing account.

detailstring

A human-readable note describing the purpose of this account.

plan_type'free' | 'basic' | 'professional' | 'unlimited'

The plan tier of the billing account. Determines resource creation limits.

plan_status'active' | 'canceling'

The subscription plan status of the billing account. Indicates whether the plan is actively running or scheduled for cancellation.

balance_creditinteger

The credit balance of the account in micros (1 USD = 1,000,000).

balance_tokeninteger

The token balance of the account.

payment_type'' | 'prepaid'

The type of payment associated with the account.

payment_method'' | 'credit card'

The method of payment used for the account.

paddle_subscription_idstring

The Paddle subscription identifier for this billing account.

paddle_customer_idstring

The Paddle customer identifier for this billing account.

tm_last_topupstring date-time

The timestamp of the last token top-up.

tm_next_topupstring date-time

The timestamp of the next scheduled token top-up.

tm_createstring date-time

The timestamp when the account was created.

tm_updatestring date-time

The timestamp when the account was last updated.

tm_deletestring date-time

The timestamp when the account was deleted, if applicable.

Example response

{
  "id": "b8c9d0e1-f2a3-4567-8901-23456789abcd",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "status": "active",
  "name": "Production Account",
  "detail": "Main billing account for production services",
  "plan_type": "basic",
  "plan_status": "active",
  "balance_credit": 1500000,
  "balance_token": 500,
  "payment_type": "prepaid",
  "payment_method": "credit card",
  "paddle_subscription_id": "sub_01h8bxq9f3e4t5a6g7h8j9k0",
  "paddle_customer_id": "ctm_01h8bxq9f3e4t5a6g7h8j9k0",
  "tm_last_topup": "2026-01-15T09:30:00.000000Z",
  "tm_next_topup": "2026-01-15T09:30:00.000000Z",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z"
}

Changes

No recorded changes to this operation across all 111 revisions of this API.