> For a complete page index, fetch https://docs.synthflow.ai/llms.txt. For full documentation content, fetch https://docs.synthflow.ai/llms-full.txt.

## Phone Numbers API enhancements

New endpoints have been added and existing endpoints have been updated for managing phone numbers.

**New endpoints:**

| Endpoint                                                                                                    | Title                 |
| ----------------------------------------------------------------------------------------------------------- | --------------------- |
| [**GET /numbers/\{phone\_number\_slug}**](/api-reference/platform-api/phone-numbers/get-phone-number)       | Get a phone number    |
| [**POST /custom-numbers**](/api-reference/platform-api/phone-numbers/create-custom-number)                  | Import phone number   |
| [**PATCH /numbers/\{phone\_number\_slug}**](/api-reference/platform-api/phone-numbers/update-phone-number)  | Update a phone number |
| [**DELETE /numbers/\{phone\_number\_slug}**](/api-reference/platform-api/phone-numbers/delete-phone-number) | Delete a phone number |

* **Get a phone number**: Retrieve detailed information about a specific phone number, including SIP configuration, capabilities, and attached assistants.
* **Import phone number**: Import custom phone numbers for direct SIP dialing scenarios.
* **Update a phone number**: Modify phone number configuration including friendly name and SIP settings.
* **Delete a phone number**: Remove a phone number from your workspace. For [purchased phone numbers](/phone-numbers), this also cancels the monthly subscription.

**Updated endpoints:**

| Endpoint                                                                  | Title              |
| ------------------------------------------------------------------------- | ------------------ |
| [**GET /numbers**](/api-reference/platform-api/phone-numbers/get-numbers) | List phone numbers |

* **List phone numbers**: Now includes pagination information (`total_records`, `limit`, `offset`) in the response.