---
title: "Purchase A Number"
method: POST
path: "/numbers/order"
tags: ["Numbers"]
---

# Purchase A Number

`POST /numbers/order`

Purchase a Number

## Request body

- object
  - `label` string — A label for the number
  - `use_extensions` boolean — Whether to use extensions
  - `record` boolean — Whether to record calls
  - `routes` object[] — Routing configuration
  - `number` string, required — The phone number to purchase
  - `provider_id` integer — The ID of the provider to use
  - `company_id` integer, required — The ID of the company to purchase the number for
  - `use_ai_ivr` boolean — Whether the AI receptionist answers on this number
  - `ai_ivr_agent_id` string, nullable — ElevenLabs agent external ID to route calls through AI IVR
  - `ai_answer_triggers` string[], nullable — When the AI receptionist answers. Empty/null means every call.
  - `fax_notification_email` string, email — Email to notify for fax
  - `number_template_id` integer — ID of the number template to apply

## Response `200`

OK

- object
  - `number` unknown

---

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