Dashboard
APICoupon Performance | Subscription Bot API
api.botsubscription.com
GET/v1/endpoint
AuthenticationBearer
Token
Stays in this tab. Required for this endpoint — the value below is what gets sent.
Examples
curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

Coupon Performance

Compare coupon redemptions and the revenue collected after discounts. Use this report for your Telegram subscription bot or Discord subscription bot project.

GET/v2/projects/{project_id}/analytics/coupons

Authorization

Bearer API KeyRequired

API key scope: analytics:charts:read for restricted keys. Unrestricted project keys also support this endpoint.

Add coupons:read to include coupon codes. Without it, codes are omitted.

Path Parameters

project_idstringrequired

Project UUID.

Query Parameters

fromstring

First UTC calendar day, YYYY-MM-DD; default to minus 29 days.

tostring

Last UTC calendar day inclusive, YYYY-MM-DD; default today.

Dates must be real calendar days between 2000-01-01 and 2099-12-31, with from no later than to and at most 366 days inclusive. Unknown query parameters are rejected. There is no request body. See the shared analytics date, money, and cache rules.

Interpreting this report

A redemption is a completed payment carrying the coupon, including balance top-ups. The chart reports paid revenue, not the discount value. Deleted coupons lose their historical link and drop out. Without coupons:read, code is omitted and coupon_codes_included is false. Rows sort by redemptions descending, then coupon ID. More than 100 qualifying coupons returns 413.

Use the project API authentication reference for API-key setup.

Last updated: