---
title: "GET /2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json"
method: GET
path: "/2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json"
tags: ["Api20100401DependentPhoneNumber"]
---

# GET /2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json

`GET /2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json`

## Request

- Base URL: `https://api.twilio.com`
- URL: `https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}/DependentPhoneNumbers.json`
- Auth: HTTP basic

## Path parameters

- `AccountSid` string, required
- `AddressSid` string, required

## Query parameters

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

## Response `200`

OK

- object
  - `end` integer
  - `first_page_uri` string, uri
  - `next_page_uri` string, uri, nullable
  - `page` integer
  - `page_size` integer
  - `previous_page_uri` string, uri, nullable
  - `start` integer
  - `uri` string, uri
  - `dependent_phone_numbers` ApiV2010AccountAddressDependentPhoneNumber[]
    - `sid` string, nullable: The unique string that that we created to identify the DependentPhoneNumber resource.
    - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the DependentPhoneNumber resource.
    - `friendly_name` string, nullable: The string that you assigned to describe the resource.
    - `phone_number` string, phone-number, nullable: The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
    - `voice_url` string, uri, nullable: The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set.
    - `voice_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
    - `voice_fallback_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
    - `voice_fallback_url` string, uri, nullable: The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`.
    - `voice_caller_id_lookup` boolean, nullable: Whether we look up the caller's caller-ID name from the CNAM database. Can be: `true` or `false`. Caller ID lookups can cost $0.01 each.
    - `date_created` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `date_updated` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `sms_fallback_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
    - `sms_fallback_url` string, uri, nullable: The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`.
    - `sms_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
    - `sms_url` string, uri, nullable: The URL we call when the phone number receives an incoming SMS message.
    - `address_requirements` 'none' | 'any' | 'local' | 'foreign': Whether the phone number requires an [Address](https://www.twilio.com/docs/usage/api/address) registered with Twilio. Can be: `none`, `any`, `local`, or `foreign`.
    - `capabilities` unknown
    - `status_callback` string, uri, nullable: The URL we call using the `status_callback_method` to send status information to your application.
    - `status_callback_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
    - `api_version` string, nullable: The API version used to start a new TwiML session.
    - `sms_application_sid` string, nullable: The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application.
    - `voice_application_sid` string, nullable: The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa.
    - `trunk_sid` string, nullable: The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa.
    - `emergency_status` 'Active' | 'Inactive': Whether the phone number is enabled for emergency calling.
    - `emergency_address_sid` string, nullable: The SID of the emergency address configuration that we use for emergency calling from the phone number.
    - `uri` string, nullable: The URI of the resource, relative to `https://api.twilio.com`.

## Changes

- **2025-07-03** (v2010) `475b69553e34`: 1 breaking
  - the `dependent_phone_numbers/items/capabilities` response's property type changed from `object` to no type for status `200`
- **2025-06-12** (v2010) `82fa0c213f54`: 1 breaking, 4 warning
  - the `dependent_phone_numbers/items/capabilities` response's property format changed from `phone-number-capabilities` to no format for status `200`
  - removed the optional property `dependent_phone_numbers/items/capabilities/fax` from the response with the `200` status
  - removed the optional property `dependent_phone_numbers/items/capabilities/mms` from the response with the `200` status
  - removed the optional property `dependent_phone_numbers/items/capabilities/sms` from the response with the `200` status
  - …1 more
- **2025-05-13** (v2010) `f74e35303f57`: 4 breaking, 4 info
  - the `dependent_phone_numbers/items/capabilities` response's property format changed from no format to `phone-number-capabilities` for status `200`
  - the `dependent_phone_numbers/items/date_created` response's property format changed from `date-time-rfc-2822` to no format for status `200`
  - the `dependent_phone_numbers/items/date_updated` response's property format changed from `date-time-rfc-2822` to no format for status `200`
  - the `dependent_phone_numbers/items/friendly_name` response's property format changed from `phone-number` to no format for status `200`
  - …4 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/Addresses/:AddressSid/DependentPhoneNumbers.json/get.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) - [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/bfdf249a1298?raw)
