Get Tracking Links (Custom Short URLs)

Use this endpoint to list your tracking links and obtain the _id, shortUrl, and longUrl values to use when sending messages.

GET https://api.cellcast.com/api/v2/tracking-link?page=1&limit=10

curl --location 'https://api.cellcast.com/api/v2/tracking-link?page=1&limit=10' \
--header 'authorization: {{API_KEY}}'

• Replace with your actual API key.
• Use the returned _id, shortUrl, and longUrl in the longUrl array when sending messages. See Quick Send SMS.

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": "tracking link found successfully!",
    "message_type": "toast",
    "data": {
        "items": [
            {
                "_id": "68ef60842000000000000000",
                "click": 0,
                "linkSequenceNumber": 0,
                "shortUrl": "cell",
                "upstreamUrl": "www.cellcast.com",
                "user": "66208cd39000000000000000",
                "expireAt": "2025-12-15T08:51:16.886Z",
                "createdAt": "2025-10-15T08:51:16.887Z",
                "updatedAt": "2025-10-15T08:51:16.887Z",
                "__v": 0
            },
            {
                "_id": "68dce7814000000000000001",
                "click": 2,
                "linkSequenceNumber": 1,
                "shortUrl": "cast",
                "upstreamUrl": "www.cellcast.com",
                "user": "66208cd39000000000000000",
                "expireAt": "2025-12-01T08:34:09.673Z",
                "createdAt": "2025-10-01T08:34:09.674Z",
                "updatedAt": "2025-10-06T04:20:36.726Z",
                "__v": 0
            }
        ],
        "total": 2,
        "limit": 10,
        "current": 1,
        "totalPages": 1,
        "pagingCounter": 1,
        "hasPrevPage": false,
        "hasNextPage": false,
        "prevPage": null,
        "nextPage": null
    },
    "error": {}
}