> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Release a Phone Number

> Release a Vobiz phone number back to inventory, stopping all billing. This permanent action cannot be undone - the number returns to the shared pool.

```http theme={null}
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/{e164}
```

Releases a phone number from your account back to inventory. This operation cannot be undone.

<Info>
  **Authentication required:**

  * `X-Auth-ID` - Your Auth ID (e.g., `{auth_id}`)
  * `X-Auth-Token` - Your account Auth Token
  * `Content-Type: application/json`
</Info>

<Warning>
  Releasing a phone number is permanent and cannot be reversed. Once released, the number returns to inventory and you lose access to it immediately. Any active calls or configurations using this number will be affected.
</Warning>

## Path parameters

* **`auth_id`** - Your account Auth ID.
* **`e164`** - The phone number to release, in E.164 format (e.g., `919876543210`). This must be a number currently assigned to your account.

<Note>
  This path uses the capital-A `/Account/` casing. The `e164` segment is taken as-is in the path. No request body is required.
</Note>

## Request

```bash cURL Request theme={null}
curl -X DELETE "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/919876543210" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"
```

## Response

A successful release returns `204 No Content` with an empty body.

```http theme={null}
HTTP/1.1 204 No Content
```

<Tip>
  **Success:** The phone number has been released from your account and returned to inventory.

  **Changes Made:**

  * `auth_id` set to NULL
  * `trunk_group_id` set to NULL
  * `released_at` timestamp set
  * Number becomes available in inventory for purchase
</Tip>

<Info>
  **Error Response (403 Forbidden):** If account does not own this number:

  ```json Error Response - 403 Forbidden theme={null}
  {
    "error": "forbidden",
    "message": "account does not own this number"
  }
  ```
</Info>


## OpenAPI

````yaml DELETE /api/v1/Account/{auth_id}/numbers/{e164}
openapi: 3.0.3
info:
  title: Vobiz API
  description: >
    The Vobiz API lets you make calls, manage phone numbers, configure SIP
    trunks, 

    and access account data programmatically.


    **Base URL:** `https://api.vobiz.ai`


    **Authentication:** All requests require `X-Auth-ID` and `X-Auth-Token`
    headers.

    Obtain these from your [Vobiz Console](https://console.vobiz.ai).
  version: '1.0'
  contact:
    email: support@vobiz.ai
    url: https://vobiz.ai
servers:
  - url: https://api.vobiz.ai
    description: Production
security:
  - AuthID: []
    AuthToken: []
tags:
  - name: Account
    description: Manage your account details and credentials
  - name: Balance
    description: Retrieve balance and transaction history
  - name: Calls
    description: Make and manage outbound calls
  - name: Live Calls
    description: Retrieve and control in-progress calls
  - name: CDR
    description: Call detail records and history
  - name: Sub-Accounts
    description: Create and manage sub-accounts
  - name: Phone Numbers
    description: Manage phone numbers on your account
  - name: Trunks
    description: Configure SIP trunks for inbound and outbound calling
  - name: Conference
    description: Manage conference calls and members
  - name: Applications
    description: Manage voice and messaging applications with webhook URLs
  - name: Endpoints
    description: Manage SIP endpoints for IP phones, softphones, and SIP clients
  - name: Partner API
    description: >-
      Reseller and white-label endpoints for managing customer sub-accounts,
      balance transfers, transactions, CDRs, and DIDs across your partner
      ecosystem
  - name: Sub-Account KYC
    description: >-
      Per-sub-account KYC verification (PAN, GST, CIN, Aadhaar, DigiLocker) and
      hosted email/redirect KYC sessions. Authenticated as the parent main
      account.
  - name: Sub-Account KYC (Test Mode)
    description: >-
      Mock KYC endpoints that never call the upstream provider. Drive verified /
      failed / pending / error outcomes with magic inputs for integration
      testing.
paths:
  /api/v1/Account/{auth_id}/numbers/{e164}:
    delete:
      tags:
        - Phone Numbers
      summary: Unrent a number
      description: Release a phone number from your account.
      operationId: unrent-number
      parameters:
        - $ref: '#/components/parameters/AuthId'
        - name: e164
          in: path
          required: true
          description: Phone number in E.164 format (without the +)
          schema:
            type: string
            example: '919876543210'
      responses:
        '204':
          description: Number released
components:
  parameters:
    AuthId:
      name: auth_id
      in: path
      required: true
      description: Your account Auth ID
      schema:
        type: string
        example: MA_XXXXXX
  securitySchemes:
    AuthID:
      type: apiKey
      in: header
      name: X-Auth-ID
      description: Your Vobiz account Auth ID
    AuthToken:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: Your Vobiz account Auth Token

````