# Phone Com Routes API

**Canonical:** https://apis.io/apis/phone-com/phone-com-routes-api/  
**Provider:** Phone Com — https://apis.io/providers/phone-com/  
**Base URL:** https://api.phone.com/v4  
**Documentation:** https://www.phone.com/api/

Phone Com Routes API is one of 68 APIs that [Phone Com](https://apis.io/providers/phone-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Routes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and 6 JSON Schemas.

Routes, a.k.a. 'Call Handling Rules' or 'Presets', are used to tell Phone.com how to handle incoming phone calls. They can be used to connect your Phone.com phone number to an extension, a menu, a calling queue, or many other things. The fundamental element of a route is an action. We support many different actions such as forward, menu, and voicemail. See below for the full details. In general, actions are processed one at a time in the order you specify, until the call is answered or disconnected. Answering or disconnecting stops any additional actions from being performed. Note that several actions such as voicemail, menu, and fax completely take over processing the call and do not result in processing any subsequent actions. Actions are grouped into rule sets. Rule sets can be filtered based on the time of day or the caller's phone number. When processing an incoming call, Phone.com's routing engine will evaluate each rule set in the order that was specified when the route was created or updated. The first matching rule set will be used, and all other rule sets will be ignored. Each route must have at least one unfiltered rule set. Note that if your route contains multiple unfiltered rule sets, only the first one will be used.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes` | Create Route for extension |
| GET | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes` | List Routes for extension |
| GET | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes/{id}` | Get Route for extension |
| PUT | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes/{id}` | Replace Route for extension |
| PATCH | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes/{id}` | Patch Route |
| DELETE | `/v4/accounts/{voip_id}/extensions/{extension_id}/routes/{id}` | Delete Route for extension |
| POST | `/v4/accounts/{voip_id}/routes` | Create Route |
| GET | `/v4/accounts/{voip_id}/routes` | List Routes |
| GET | `/v4/accounts/{voip_id}/routes/{id}` | Get Route |
| PUT | `/v4/accounts/{voip_id}/routes/{id}` | Replace Route |
| PATCH | `/v4/accounts/{voip_id}/routes/{id}` | Patch Route |
| DELETE | `/v4/accounts/{voip_id}/routes/{id}` | Delete Route |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/openapi/phone-com-routes-api-openapi.yml
- **Documentation** — https://docs.phone.com/
- **APIReference** — https://apidocs.phone.com/reference
- **GettingStarted** — https://docs.phone.com/aboutdevenv/aboutdevenvhome.html
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-live-answer-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-route-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-extension-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-events-overview-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-account-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/phone-com/refs/heads/main/json-schema/phone-com-extension-contact-schema.json

## Other Phone Com APIs (12)

- [Phone Com 10 DLC API](https://apis.io/apis/phone-com/phone-com-10-dlc-api/)
- [Phone Com Access Tokens API](https://apis.io/apis/phone-com/phone-com-access-tokens-api/)
- [Phone Com Account Contacts API](https://apis.io/apis/phone-com/phone-com-account-contacts-api/)
- [Phone Com Accounts API](https://apis.io/apis/phone-com/phone-com-accounts-api/)
- [Phone Com API Endpoint Statistics API](https://apis.io/apis/phone-com/phone-com-api-endpoint-statistics-api/)
- [Phone Com API Errors API](https://apis.io/apis/phone-com/phone-com-api-errors-api/)
- [Phone Com Asynchronous Call Logs API](https://apis.io/apis/phone-com/phone-com-asynchronous-call-logs-api/)
- [Phone Com Available Phone Numbers API](https://apis.io/apis/phone-com/phone-com-available-phone-numbers-api/)
- [Phone Com Blocked Calls API](https://apis.io/apis/phone-com/phone-com-blocked-calls-api/)
- [Phone Com Call Logs API](https://apis.io/apis/phone-com/phone-com-call-logs-api/)
- [Phone Com Call Reports API](https://apis.io/apis/phone-com/phone-com-call-reports-api/)
- [Phone Com Caller IDs API](https://apis.io/apis/phone-com/phone-com-caller-ids-api/)

## Tags

Routes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/phone-com/phone-com-routes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/phone-com/.