Auth

Schedule or immediately execute account deletion (self-service).

Changed on

Marks the authenticated customer's account for deletion. The account enters 'frozen' state immediately. Active calls are terminated and new operations are blocked.

By default, the customer has 30 days to recover via DELETE /auth/unregister before permanent deletion.

If immediate is set to true, the account is frozen and then permanently deleted (PII anonymized, all resources cascade-deleted) in a single request. This cannot be undone.

Exactly one of password or confirmation_phrase must be provided:

  • Password-based accounts: provide password for re-authentication.
  • SSO or API-key authenticated requests: provide confirmation_phrase set to "DELETE".
post/auth/unregister

Request

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/auth/unregister
  • Auth
    none declared

Query parameters

accesskeystring

API access key token. Returned from the GET /accesskeys response. Alternative to Bearer token authentication.

Request body

passwordstring

Account password for re-authentication. Required for password-based accounts. Mutually exclusive with confirmation_phrase.

confirmation_phrasestring

Must be exactly "DELETE". Required for SSO users and API-key authenticated requests. Mutually exclusive with password.

immediateboolean

If true, skip the 30-day grace period and delete the account immediately. The account is frozen and then permanently deleted (PII anonymized, all resources cascade-deleted) in a single request. Default: false.

Example request

{
  "password": "mySecurePassword123",
  "confirmation_phrase": "DELETE"
}

Response

Account frozen successfully (or deleted if immediate was true).

idstring uuid

The unique identifier of the customer.

namestring

Name of the customer.

detailstring

Details about the customer.

emailstring email

Email address of the customer.

phone_numberstring

Customer's contact phone number in E.164 format.

addressstring

Address of the customer.

webhook_method'' | 'POST' | 'GET' | 'PUT' | 'DELETE'

The HTTP method used for webhook (e.g., POST, GET, PUT, DELETE).

webhook_uristring

URI where webhook events are delivered.

billing_account_idstring uuid

The unique identifier of the customer's default billing account. Returned from the GET /billing_accounts/{id} response.

email_verifiedboolean

Whether the customer's email has been verified.

status'initial' | 'active' | 'frozen' | 'deleted' | 'expired'

Account lifecycle status.

identity_verification_status'none' | 'pending' | 'verified' | 'rejected'

Customer's identity verification status. Determines access to PSTN number purchases and outbound PSTN calls.

tm_deletion_scheduledstring date-time

Timestamp when account deletion was requested. Null if not scheduled.

tm_createstring date-time

Timestamp when the customer was created.

tm_updatestring date-time

Timestamp when the customer was last updated.

tm_deletestring date-time

Timestamp when the customer was deleted.

Example response

{
  "id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "name": "Acme Corporation",
  "detail": "Enterprise customer account",
  "email": "admin@acme.com",
  "phone_number": "+14155551234",
  "address": "123 Main St, San Francisco, CA 94105",
  "webhook_method": "POST",
  "webhook_uri": "https://api.acme.com/webhooks/voipbin",
  "billing_account_id": "b8c9d0e1-f2a3-4567-8901-23456789abcd",
  "metadata": {
    "rtp_debug": true
  },
  "email_verified": true,
  "status": "active",
  "identity_verification_status": "none",
  "tm_deletion_scheduled": "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

  • 79e779080bccRevision changes
    • warning

      added the new expired enum value to the response property for the response status

    • warning

      added the new initial enum value to the response property for the response status