---
title: "Get call routes"
method: GET
path: "/callrouting/1/routes"
tags: ["channels", "voice", "routing", "call-routing-configurations"]
---

# Get call routes

`GET /callrouting/1/routes`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/callrouting/1/routes`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Get existing call routes with pagination.

## Query parameters

- `nameContains` string
- `page` integer
- `size` integer

## Response `200`

Success

- 5cb8669321a9b28a95445a23a292423b19c28f831eda62032aef9c6b53da7813RouteResponsePage: Routes response object.
  - `results` 1e938b22275568ebc747d21724b50c9be18ff5770eb33c37b76fda4633c14bdeRouteResponse[]: The list of the results for this page.
    - `id` string, required: Unique identifier of a route.
    - `name` string, required: Route name.
    - `criteria` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8SearchCriteria[]: List of criteria that should match route. For a route to match, any criterion should be met.
      - `to` string: Phone number or regular expression pattern representing the phone number. Applies to all search criteria types except `WEBRTC`. Examples: `41793026727`, `41793(.+)`.
      - `value` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8Criteria: Criteria type.
        - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'APPLICATION' | 'WHATSAPP', required
    - `destinations` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8Destination[], required: List of destinations. First destination in the list is the first one to be executed. Subsequent destinations are executed only if the previous one fails.
      - `priority` integer
      - `type` 'APPLICATION' | 'ENDPOINT' | 'URL', required
      - `weight` integer
    - `status` 'ENABLED' | 'DISABLED', required: Indicates whether the route is enabled or not.
    - `order` integer: Indicates priority index of the route. Routes with lower priority index are executed first.
    - `transferOnly` boolean: Indicates whether this route should be used exclusively for call transfers initiated via the REFER SIP message. The `to` number value will be taken from the `Refer-To` header.
  - `paging` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8PageInfo: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)