List Phone Numbers - API

Returns a paginated list of the authenticated user's phone numbers, each enriched with its resolved inbound and outbound SIP gateways (batched server-side). Numbers without an attached gateway return inbound: null and/or outbound: null.

Inbound gateways do not expose address, auth, or transport credentials in the response shape — those fields are outbound-only and appear as address: null / auth: {} for inbound entries.

HTTP method and endpoint

GET

|

https://api.videosdk.live/v2/sip/phone-numbers

Headers Parameters

Authorization

REQUIRED

values: YOUR_TOKEN_WITHOUT_ANY_PREFIX

This will be a JWT token generate using VideoSDK ApiKey and Secret.

Note that the token will not include any prefix such as "Basic " or "Bearer ". Just pass a token as value.

You can generate a new token by refering this Guide: Generate Auth token

Query Parameters

page

OPTIONAL

Page number for pagination. Defaults to 1.

perPage

OPTIONAL

Number of records per page. Defaults to 20, capped at 100.

search

OPTIONAL

Case-insensitive regex match against name and e164.

Response Parameters

data

Array of { phoneNumber, inbound, outbound } triples. inbound / outbound are gateway objects, or null when the number is not attached.

pagination

Pagination metadata: page, perPage, total, totalPages.

GET

|

https://api.videosdk.live/v2/sip/phone-numbers

NodeJS

• cURL
• NodeJS
• PHP
• Python

import fetch from 'node-fetch';
const options = {
	method: "GET",
	headers: {
		"Authorization": "$YOUR_TOKEN",
	},
};
const url= `https://api.videosdk.live/v2/sip/phone-numbers?page=1&perPage=20&search=`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);

RESPONSE

{
  "data": [
    {
      "phoneNumber": {
        "phoneNumberId": "pn_abc123",
        "e164": "+14155551234",
        "countryCode": "US",
        "provider": "other",
        "origin": "SIP Configured",
        "status": "ACTIVE",
        "createdAt": "2026-05-11T10:00:00.000Z",
        "updatedAt": "2026-05-11T10:00:00.000Z",
        "name": "My SIP Setup"
      },
      "inbound": {
        "id": "gw_inbound_uuid",
        "address": null,
        "numbers": [
          "+14155551234",
          "+14155555678"
        ],
        "mediaEncryption": "disable",
        "transport": "tls",
        "geoRegion": "us002",
        "auth": {}
      },
      "outbound": {
        "id": "gw_outbound_uuid",
        "address": "sip.telnyx.com:5061",
        "numbers": [
          "+14155551234",
          "+14155555678"
        ],
        "mediaEncryption": "disable",
        "transport": "tls",
        "geoRegion": "us002",
        "auth": {
          "username": "sip-user",
          "password": "sip-pass"
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}