---
title: "Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page."
method: GET
path: "/v1/Services"
tags: ["ProxyV1Service"]
---

# Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page.

`GET /v1/Services`

Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page.

## Query parameters

- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `services` ProxyV1Service[]
    - `sid` string, nullable — The unique string that we created to identify the Service resource.
    - `unique_name` string, nullable — An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.**
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource.
    - `chat_instance_sid` string, nullable — The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship.
    - `callback_url` string, uri, nullable — The URL we call when the interaction status changes.
    - `default_ttl` integer — The default `ttl` value for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session's last create or last Interaction. The default value of `0` indicates an unlimited Session length. You can override a Session's default TTL value by setting its `ttl` value.
    - `number_selection_behavior` 'avoid-sticky' | 'prefer-sticky' — The preference for Proxy Number selection in the Service instance. Can be: `prefer-sticky` or `avoid-sticky`. `prefer-sticky` means that we will try and select the same Proxy Number for a given participant if they have previous [Sessions](https://www.twilio.com/docs/proxy/api/session), but we will not fail if that Proxy Number cannot be used. `avoid-sticky` means that we will try to use different Proxy Numbers as long as that is possible within a given pool rather than try and use a previously assigned number.
    - `geo_match_level` 'area-code' | 'overlay' | 'radius' | 'country' — Where a proxy number must be located relative to the participant identifier. Can be: `country`, `area-code`, or `extended-area-code`. The default value is `country` and more specific areas than `country` are only available in North America.
    - `intercept_callback_url` string, uri, nullable — The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues.
    - `out_of_session_callback_url` string, uri, nullable — The URL we call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio [function](https://www.twilio.com/en-us/serverless/functions)) responds with valid [TwiML](https://www.twilio.com/docs/voice/twiml), we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See [Out-of-Session Callback Response Guide](https://www.twilio.com/docs/proxy/out-session-callback-response-guide) for more information.
    - `date_created` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.
    - `date_updated` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.
    - `url` string, uri, nullable — The absolute URL of the Service resource.
    - `links` object, nullable — The URLs of resources related to the Service.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-02-20** (v1) `1469851deee4` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2024-08-26** (v1) `5d96b79babfd` — 1 info
  - the `default_ttl` response's property default value `0` was added for the status `200`
- **2023-08-10** (v1) `6b9a26829560` — 1 info
  - api tag `ProxyV1Service` added
- **2023-02-02** (v1) `c4b95f6536e9` — 2 info
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageToken`
- **2023-01-13** (v1) `0f96912d65f8` — 2 breaking
  - the response property `meta/next_page_url` became nullable for the status `200`
  - the response property `meta/previous_page_url` became nullable for the status `200`

[Change history](https://skmtc.dev/twilio/apis/proxy-v1/changes/v1/Services/get.md)

---

[API](https://skmtc.dev/twilio/apis/proxy-v1.md) · [All operations](https://skmtc.dev/twilio/apis/proxy-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/proxy-v1/revisions/a2e6d27b3ecd/schema)