Delete Offer

{
  "success": true,
  "archived": true
}

{
  "error": "Offer not found",
  "code": "not_found"
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

DELETE

offers

{id}

{
  "success": true,
  "archived": true
}

{
  "error": "Offer not found",
  "code": "not_found"
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

Soft-deletes an offer by setting its status to archived. The offer is not permanently removed from the system and can be restored by updating its status back to active or paused via the Update Offer endpoint. Archived offers are excluded from the default List Offers response unless you explicitly filter by status=archived.

Path Parameters

string

required

The unique identifier of the offer to archive.

Response Fields

boolean

Indicates whether the offer was archived successfully.

boolean

Confirms the offer has been set to archived status.

Examples

cURL

curl -X DELETE "https://api.tracklysms.com/api/v2/offers/664f1a2b3c4d5e6f7a8b9c0d" \
  -H "X-Api-Key: trk_your_api_key_here"

Python

import requests

offer_id = "664f1a2b3c4d5e6f7a8b9c0d"

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

data = response.json()
print(data)  # {"success": True, "archived": True}

Node.js

const offerId = "664f1a2b3c4d5e6f7a8b9c0d";

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

const data = await response.json();
console.log(data);  // { success: true, archived: true }

{
  "success": true,
  "archived": true
}

{
  "error": "Offer not found",
  "code": "not_found"
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

Error Codes

HTTP Status	Error Code	Description
401	`invalid_credentials`	API key is missing or invalid.
403	`account_suspended`	Your account is suspended. Resolve outstanding billing or contact support.
429	`rate_limited`	Request throttled; retry with exponential backoff after the window resets.
404	`not_found`	No offer exists with the specified ID.
500	`server_error`	An unexpected error occurred on the server.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

Path Parameters

Response Fields

Examples

Error Codes

Next Steps

Offers Overview

Record Revenue

​Path Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Offers Overview

Record Revenue

Path Parameters

Response Fields

Examples

Error Codes

Next Steps