Skip to main content
GET
/
api
/
v2
/
crm-actions
/
phone-numbers
List phone numbers
curl --request GET \
  --url https://api.instantly.ai/api/v2/crm-actions/phone-numbers \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "019d9c5f-cc59-7ddc-bb6c-2d354534c2e2",
    "timestamp_created": "2026-04-17T16:56:57.177Z",
    "organization_id": "019d9c5f-cc59-7ddc-bb6c-2d3657c3a4e3",
    "phone_number": "+15551234567",
    "country": "US",
    "locality": "San Francisco",
    "subscription_id": "sub_1PuaE1B3VEKBA0ygDAKk7QVc",
    "twilio_sid": "PN998dda028e07a49c8038b2206341d463",
    "renewal_date": "2026-04-17T16:56:57.177Z",
    "price": 1
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Default Response

​
id
string

Unique identifier of the phone number record.

Example:

"019d9c5f-cc59-7ddc-bb6c-2d354534c2e2"

​
timestamp_created
string<date-time>

Timestamp when the phone number record was created.

Example:

"2026-04-17T16:56:57.177Z"

​
organization_id
string

Identifier of the organization that owns this phone number.

Example:

"019d9c5f-cc59-7ddc-bb6c-2d3657c3a4e3"

​
phone_number
string

The phone number in international E.164 format.

Example:

"+15551234567"

​
country
string

Country code where the phone number is registered.

Example:

"US"

​
locality
string

City or region associated with the phone number.

Example:

"San Francisco"

​
subscription_id
string

Billing subscription ID linked to this phone number.

Example:

"sub_1PuaE1B3VEKBA0ygDAKk7QVc"

​
twilio_sid
string

Twilio resource SID for the phone number.

Example:

"PN998dda028e07a49c8038b2206341d463"

​
renewal_date
string<date>

Next renewal date for the phone number subscription.

Example:

"2026-04-17T16:56:57.177Z"

​
price
number

Monthly price for this phone number (USD).

Example:

1