--- title: "GET /v1/Services" method: GET path: "/v1/Services" tags: ["MessagingV1Service"] --- # GET /v1/Services `GET /v1/Services` ## Query parameters - `PageSize` integer - `Page` integer - `PageToken` string ## Response `200` OK - object - `services` MessagingV1Service[] - `sid` string, nullable — The unique string that we created to identify the Service resource. - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. - `friendly_name` string, nullable — The string that you assigned to describe the resource. - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `inbound_request_url` string, uri, nullable — The URL we call using `inbound_method` when a message is received by any phone number or short code in the Service. When this property is `null`, receiving inbound messages is disabled. All messages sent to the Twilio phone number or short code will not be logged and received on the Account. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `inbound_request_url` defined for the Messaging Service. - `inbound_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call `inbound_request_url`. Can be `GET` or `POST`. - `fallback_url` string, uri, nullable — The URL that we call using `fallback_method` if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `fallback_url` defined for the Messaging Service. - `fallback_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call `fallback_url`. Can be: `GET` or `POST`. - `status_callback` string, uri, nullable — The URL we call to [pass status updates](https://www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery. - `sticky_sender` boolean, nullable — Whether to enable [Sticky Sender](https://www.twilio.com/docs/messaging/services#sticky-sender) on the Service instance. - `mms_converter` boolean, nullable — Whether to enable the [MMS Converter](https://www.twilio.com/docs/messaging/services#mms-converter) for messages sent through the Service instance. - `smart_encoding` boolean, nullable — Whether to enable [Smart Encoding](https://www.twilio.com/docs/messaging/services#smart-encoding) for messages sent through the Service instance. - `scan_message_content` 'inherit' | 'enable' | 'disable' — Reserved. - `fallback_to_long_code` boolean, nullable — [OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures. - `area_code_geomatch` boolean, nullable — Whether to enable [Area Code Geomatch](https://www.twilio.com/docs/messaging/services#area-code-geomatch) on the Service Instance. - `synchronous_validation` boolean, nullable — Reserved. - `validity_period` integer — How long, in seconds, messages sent from the Service are valid. Can be an integer from `1` to `36,000`. Default value is `36,000`. - `url` string, uri, nullable — The absolute URL of the Service resource. - `links` object, nullable — The absolute URLs of related resources. - `usecase` string, nullable — A string that describes the scenario in which the Messaging Service will be used. Possible values are `notifications`, `marketing`, `verification`, `discussion`, `poll`, `undeclared`. - `us_app_to_person_registered` boolean, nullable — Whether US A2P campaign is registered for this Service. - `use_inbound_webhook_on_number` boolean, nullable — A boolean value that indicates either the webhook url configured on the phone number will be used or `inbound_request_url`/`fallback_url` url will be called when a message is received from the phone number. If this field is enabled then the webhook url defined on the phone number will override the `inbound_request_url`/`fallback_url` defined for the Messaging 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) `96ed54055a05` — 1 breaking - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64` - **2024-08-26** (v1) `9c7bdebb1c4b` — 1 info - the `validity_period` response's property default value `0` was added for the status `200` - **2024-05-24** (v1) `99116c0327cb` — 1 warning - removed the optional property `services/items/sending_windows` from the response with the `200` status - **2024-04-18** (v1) `88bdad18669e` — 8 info - removed the `DELETE` enum value from the `services/items/fallback_method` response property for the response status `200` - removed the `DELETE` enum value from the `services/items/inbound_method` response property for the response status `200` - removed the `HEAD` enum value from the `services/items/fallback_method` response property for the response status `200` - removed the `HEAD` enum value from the `services/items/inbound_method` response property for the response status `200` - …4 more - **2024-04-04** (v1) `55d8cb83916f` — 1 info - added the optional property `services/items/sending_windows` to the response with the `200` status [Full history](https://skmtc.dev/twilio/apis/twilio-messaging/changes/v1/Services/get.md) --- [API](https://skmtc.dev/twilio/apis/twilio-messaging.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-messaging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/twilio-messaging/revisions/68d7beef549e/schema)