---
title: "Request a phone number"
method: POST
path: "/phone-numbers/requests"
tags: ["Phone numbers"]
---

# Request a phone number

`POST /phone-numbers/requests`

## Request

- Base URL: `https://api.flogpt.com/api/v1`
- URL: `https://api.flogpt.com/api/v1/phone-numbers/requests`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Numbers cannot be purchased through this API. Self-serve provisioning
covers only a handful of countries; everywhere else needs KYC or carrier
paperwork, so this files a request a floGPT admin fulfils by hand.

One open request per country — a second returns `409`.

## Request body

- object
  - `country` string, required: ISO 3166-1 alpha-2.
  - `areaCodePreference` string
  - `useCase` 'customer_support' | 'appointment_booking' | 'lead_generation' | 'sales' | 'survey_feedback' | 'ads_to_call' | 'other'
  - `direction` 'inbound' | 'outbound' | 'both'
  - `notes` string
  - `callWidgetId` string

## Response `201`

Request filed

## Other responses

- `409`: An open request for that country already exists

---

[API](https://skmtc.dev/flogpt/apis/flogpt-organization-api.md) · [All operations](https://skmtc.dev/flogpt/apis/flogpt-organization-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flogpt/apis/flogpt-organization-api/revisions/c3a6cff76797?raw)