Coupons · Tentary API Reference

Coupons

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

GET / v1 / coupons

The coupons (discount codes), newest first: code, status, state, percent or amount, uses and use limit, start and end day, the products they apply to (with their status live, draft, archived or deleted), and admin links.

status is what you set: active or archived. Without status, the list has active coupons only. Archived coupons are deleted coupons.

state is the result for buyers, and read only:

valid: buyers can use the code now.
scheduled: the start is in the future.
expired: the end is in the past.
used_up: the use limit is reached.
archived: deleted.
no_products: the coupon applies to no live product. The checkout sells only live products.
reserved: open checkouts of the last hour hold the remaining uses. They become free again if the buyers do not pay.

The fields have the same names and formats as in POST /v1/coupons and PATCH /v1/coupons/{coupon_id}.

Reads only MCP tool list_coupons

curl "https://api.tentary.com/v1/coupons" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/coupons", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/coupons",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/coupons');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "coupons": [
    {
      "id": 701,
      "code": "SPRING20",
      "status": "active",
      "state": "valid",
      "percent": 20,
      "amount": null,
      "currency": "EUR",
      "used": 12,
      "max_uses": 100,
      "reserved_in_open_checkouts": 0,
      "starts_on": null,
      "ends_on": "2026-11-26",
      "product_ids": null,
      "products": [],
      "created_at": "2026-09-27T10:00:00Z",
      "admin_url": "https://app.tentary.com/discounts/edit/701"
    }
  ],
  "next_cursor": null,
  "links": {
    "coupons": "https://app.tentary.com/discounts",
    "new_coupon": "https://app.tentary.com/discounts/new"
  }
}

Authorization

Authorization string header required

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Introduction

Query parameters

status string

active (default) or archived.

Allowed values: activearchived
cursor string

next_cursor of the previous page. Send the same filters and limit again: the cursor does not keep them. Leave out for the first page.
limit integer

Items per page, default 25.

min 1 max 50

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

coupons array of object

Newest first.
Show 16 fields Hide fields
- id integer
  
  The ID.
- code string
  
  The code buyers type.
- status string
  
  What the seller set. archived = deleted.
  
  Allowed values: activearchived
- state string
  
  The result for buyers: valid = buyers can use the code now.
  
  Allowed values: validscheduledexpiredused_upreservedarchivedno_products
- percent integer can be null
  
  Discount in percent, or null for a fixed amount.
- amount string can be null
  
  Decimal string, like "19.90". Fixed discount, or null for a percent discount.
- currency string
  
  Currency code, like EUR.
- used integer
  
  How often the code was used.
- max_uses integer can be null
  
  null = no limit.
- reserved_in_open_checkouts integer
  
  Uses held by open checkouts of the last hour.
- starts_on string<date> can be null
  
  Like 2026-01-31. First day the code works.
- ends_on string<date> can be null
  
  Like 2026-01-31. The code stops at the start of this day.
- product_ids array of integer can be null
  
  null = all products. [] = no product.
- products array of object
  
  The products of product_ids (the first 200).
  Show 3 fields Hide fields
  
  id integer
  
  The ID.
  
  name string can be null
  
  The name.
  
  status string
  
  The status.
  
  Allowed values: livedraftarchiveddeleted
- created_at string<date-time> can be null
  
  UTC, like 2026-01-31T14:05:00Z.
- admin_url string<uri>
  
  The page in the Tentary app.
next_cursor string can be null

Send it as cursor for the next page, with the same filters and limit. null = this is the last page.
links object

Pages in the Tentary app or on tentary.com.
Show 2 fields Hide fields
- coupons string<uri>
  
  Page in the Tentary app.
- new_coupon string<uri>
  
  Page in the Tentary app.