Owned Virtual Numbers

This API is used to retrieve a list of virtual numbers owned/dedicated to your account.

Parameters for Getting Owned Virtual Numbers

Headers Parameters

Parameters	Description
Authorization	Please add provided Bearer token - linked to your Cellcast account. Check here
Content-Type	application/json

Code Samples

Get https://api.cellcast.com/api/v1/virtual-number/dedicated

cURL

curl --location 'https://api.cellcast.com/api/v1/apiClient/virtual-number/dedicated' \
--header 'authorization: Bearer {{API_KEY}}'

node.js

const axios = require('axios');

async function getOwnedVirtualNumbers() {
    const url = 'https://api.cellcast.com/api/v1/apiClient/virtual-number/dedicated';
    const apiKey = 'your_api_key_here'; // Replace with your actual API key

    try {
        const response = await axios.get(url, {
            headers: {
                Authorization: `Bearer ${apiKey}`,
                'Content-Type': 'application/json',
            },
        });

        console.log('Response:', response.data);
    } catch (error) {
        console.error('Error:', error.response ? error.response.data : error.message);
    }
}

getOwnedVirtualNumbers();

Replace with the actual API key that you own.

Responses

200 Success

{
  "app_type": "web",
  "app_version": "1.0",
  "maintainence": 0,
  "new_version": 0,
  "force_update": 0,
  "invalid_token": 0,
  "refresh_token": "",
  "show_message": 0,
  "is_enc": false,
  "status": true,
  "message": "Success",
  "message_type": "toast",
  "data": [
    {
      "_id": "689ef2fceb4a550fdc561c9c",
      "audNumber": "61414682664",
      "status": "pending",
      "totalAmount": 168,
      "billingStatus": "yearly",
      "activationTime": "2025-11-19T15:31:59.000Z",
      "expirationTime": "2026-11-19T15:31:59.000Z",
      "isDefault": false,
      "type": "MMS",
      "assignedUserId": "680f524350eb4e38fead5161",
      "createdAt": "2025-08-28T10:02:43.747Z",
      "updatedAt": "2025-12-03T09:13:20.960Z",
      "needsActivation": true
    }
  ],
  "error": {
    
  }
}

401 Unauthorized

{
  "code": 401,
  "message": "Token expired",
  "stack": "APIError: Token expired ...."
}