---
title: "Purchase from Inventory"
method: POST
path: "/api/v1/Account/{auth_id}/numbers/purchase-from-inventory"
tags: ["Phone Numbers"]
---

# Purchase from Inventory

`POST /api/v1/Account/{auth_id}/numbers/purchase-from-inventory`

## Request

- Base URL: `https://api.vobiz.ai`
- URL: `https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/purchase-from-inventory`
- Auth: API key in header `X-Auth-ID` and API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/vobiz/apis/vobiz-api/docs/api/v1/Account/:auth_id/numbers/purchase-from-inventory/post.ts> (a function with typed inputs; its response is checked against the schema)

Purchase a phone number from inventory and assign it to your account.
Debits your account balance for the setup fee and monthly fee. For
sub-accounts (SA_), the parent master account (MA_) is charged.

## Path parameters

- `auth_id` string, required

## Request body

- object
  - `e164` string, required: Phone number to purchase in E.164 format.
  - `currency` string: Currency for transaction. Defaults to the number's currency or "USD".

## Response `200`

Number purchased

## Other responses

- `404`: Number not found in inventory
- `500`: Failed to purchase number

---

[API](https://skmtc.dev/vobiz/apis/vobiz-api.md) - [All operations](https://skmtc.dev/vobiz/apis/vobiz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vobiz/apis/vobiz-api/revisions/863f08cd6737?raw)