Skip to main content
GET
/
v2
/
offers
/
{id}
{
  "id": "664f1a2b3c4d5e6f7a8b9c0d",
  "name": "Summer Promo",
  "tracking_url": "https://track.example.com/click?offer_id=123",
  "external_platform": "tune",
  "external_id": "4521",
  "advertiser_id": "adv_882",
  "payout": 2.50,
  "payout_type": "cpa",
  "filter_bots": true,
  "status": "active",
  "metadata": {
    "vertical": "health",
    "geo": "US"
  },
  "created_at": "2025-11-01T14:30:00Z",
  "updated_at": "2025-12-15T09:12:00Z"
}
Returns the full details of a specific offer. The offer must belong to your account.

​
Path Parameters

​
id
string
required
The unique identifier of the offer.

​
Response Fields

​
id
string
Unique identifier for the offer.
​
name
string
Display name of the offer.
​
tracking_url
string
The tracking/click URL for this offer.
​
external_platform
string
The external affiliate platform. One of tune, everflow, or null.
​
external_id
string
The offer ID on the external platform.
​
advertiser_id
string
The advertiser ID associated with the offer.
​
payout
float
Payout amount for the offer.
​
payout_type
string
Payout model. One of cpa or cpc.
​
filter_bots
boolean
Whether bot click filtering is enabled.
​
status
string
Current status of the offer: active, paused, or archived.
​
metadata
object
Custom key-value metadata attached to the offer.
​
created_at
datetime
ISO 8601 timestamp of when the offer was created.
​
updated_at
datetime
ISO 8601 timestamp of the last update.

​
Examples

cURL
curl -X GET "https://app.tracklysms.com/api/v2/offers/664f1a2b3c4d5e6f7a8b9c0d" \
  -H "X-Api-Key: trk_your_api_key_here"
Python
import requests

offer_id = "664f1a2b3c4d5e6f7a8b9c0d"

response = requests.get(
    f"https://app.tracklysms.com/api/v2/offers/{offer_id}",
    headers={"X-Api-Key": "trk_your_api_key_here"}
)

offer = response.json()
print(offer["name"], offer["status"])
Node.js
const offerId = "664f1a2b3c4d5e6f7a8b9c0d";

const response = await fetch(
  `https://app.tracklysms.com/api/v2/offers/${offerId}`,
  {
    headers: {
      "X-Api-Key": "trk_your_api_key_here"
    }
  }
);

const offer = await response.json();
console.log(offer.name, offer.status);

{
  "id": "664f1a2b3c4d5e6f7a8b9c0d",
  "name": "Summer Promo",
  "tracking_url": "https://track.example.com/click?offer_id=123",
  "external_platform": "tune",
  "external_id": "4521",
  "advertiser_id": "adv_882",
  "payout": 2.50,
  "payout_type": "cpa",
  "filter_bots": true,
  "status": "active",
  "metadata": {
    "vertical": "health",
    "geo": "US"
  },
  "created_at": "2025-11-01T14:30:00Z",
  "updated_at": "2025-12-15T09:12:00Z"
}

​
Error Codes

HTTP StatusError CodeDescription
401unauthorizedAPI key is missing or invalid.
404not_foundNo offer exists with the specified ID.
500server_errorAn unexpected error occurred on the server.

​
Next Steps

Offers Overview

Manage offers and payouts

Record Revenue

Track revenue for this offer