List phone numbers

Retrieve all phone numbers associated with the current organization.

Requires one of the following scopes: crm_actions:read, crm_actions:all, all:read, all:all

GET /api/v2/crm-actions/phone-numbers

List phone numbers

cURL

curl --request GET \
  --url https://api.instantly.ai/api/v2/crm-actions/phone-numbers \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "019e3bd1-b563-73ee-b6cb-1da263dcb094",
    "timestamp_created": "2026-05-18T16:00:59.747Z",
    "organization_id": "019e3bd1-b563-73ee-b6cb-1da34f4a3793",
    "phone_number": "[phone]",
    "country": "US",
    "locality": "San Francisco",
    "subscription_id": "sub_1PuaE1B3VEKBA0ygDAKk7QVc",
    "twilio_sid": "PN998dda028e07a49c8038b2206341d463",
    "renewal_date": "2026-05-18T16:00:59.747Z",
    "price": 1
  }
]

Authorizations

Authorization · string · header · required

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

Response

200

application/json

Default Response

id · string

Unique identifier of the phone number record.

Example:

"019e3bd1-b563-73ee-b6cb-1da263dcb094"

timestamp_created · string<date-time>

Timestamp when the phone number record was created.

Example:

"2026-05-18T16:00:59.747Z"

organization_id · string

Identifier of the organization that owns this phone number.

Example:

"019e3bd1-b563-73ee-b6cb-1da34f4a3793"

phone_number · string

The phone number in international E.164 format.

Example:

"[phone]"

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-05-18T16:00:59.747Z"

price · number

Monthly price for this phone number (USD).

Example:

1