---
title: "Purchases phone numbers."
method: POST
path: "/availablePhoneNumbers/:purchase"
tags: ["Find and purchase available phone numbers"]
---

# Purchases phone numbers.

`POST /availablePhoneNumbers/:purchase`

## Query parameters

- `api-version` string, required

## Request body

- PhoneNumberPurchaseRequest — The phone number search purchase request.
  - `searchId` string — The search id.
  - `agreeToNotResell` boolean — The agreement to not resell the phone numbers. Defaults to false if not provided.

## Response `202`

The service has accepted the request and will start processing later. It will return 'Accepted' immediately and include an 'Operation-Location' header. Client side should further query the operation status using the URL specified in 'Operation-Location' header.

## Other responses

- `default` — Failure

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)