---
title: "Purchase Number"
method: POST
path: "/assistants/v1/numbers/purchase"
tags: ["Phone Numbers"]
---

# Purchase Number

`POST /assistants/v1/numbers/purchase`

Purchases a number.

## Request body

- object
  - `number` string — Phone number to purchase. Please provide in E.164 format, Ex: +1234567890

## Response `200`

Successfully purchased the number.

- Number
  - `_id` string, objectId, required — Unique identifier of the number
  - `teamId` string, objectId, required — This is unique identifier of the team.
  - `number` string, required — Phone number associated with the team
  - `provider` object, required
    - `name` string — Name of the provider
  - `assistantId` string — ID of the associated assistant (if any)
  - `inboundEnabled` boolean — If true, inbound call is enabled. If false, inbound call is disabled.
  - `outboundEnabled` boolean — If true, outbound call is enabled. If false, outbound call is disabled.
  - `label` string — Label for the number

## Other responses

- `400` — Invalid request body.
- `409` — The number already purchased.
- `500` — Internal server error.

---

[API](https://skmtc.dev/interactly/apis/interactly-api.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api/revisions/8a408fde89f6/schema)