Affiliates

Affiliate sales

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 / affiliates / sales

The commissions of the affiliate partners, newest first. There is one row per paid order or subscription payment and level.

level 1: the partner sold it.
level 2: commission for the partner who recruited the selling partner (source_partner_id). Level 2 rows exist only for sales after the partner was recruited.
status: accepted, under_review, paid (paid out), declined or void (the order was refunded).
amount: the payment. It is 0.00 after a 100% coupon. The commission is in the same currency.

A fixed commission (see GET /v1/affiliates) does not depend on amount.

Reads only MCP tool list_affiliate_sales

curl "https://api.tentary.com/v1/affiliates/sales?partner_id=900" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/affiliates/sales?partner_id=900", {
  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/affiliates/sales",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    params={
        "partner_id": 900,
    },
)
data = response.json()

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

200 · Response

{
  "sales": [
    {
      "order_id": 1001,
      "subscription_payment": false,
      "date": "2026-09-17T09:14:22Z",
      "product_id": 101,
      "product_title": "Yoga Basics E-Book",
      "amount": "19.00",
      "currency": "EUR",
      "partner_id": 900,
      "level": 1,
      "source_partner_id": null,
      "commission": "5.70",
      "status": "accepted",
      "admin_url": "https://app.tentary.com/orders/view/1001"
    }
  ],
  "next_cursor": null,
  "admin_url": "https://app.tentary.com/affiliates/sales"
}

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

partner_id integer

Only this partner (id from list_affiliates).

min 1 Example: 900
from string

First day (UTC), like 2026-01-01.

pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
to string

Last day (UTC).

pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
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.

sales array of object

Newest first.
Show 13 fields Hide fields
- order_id integer
  
  The order ID (not the order number).
- subscription_payment boolean
  
  true = a renewal payment of a subscription.
- date string<date-time> can be null
  
  UTC, like 2026-01-31T14:05:00Z.
- product_id integer can be null
  
  The product ID.
- product_title string can be null
  
  The product name.
- amount string can be null
  
  Decimal string, like "19.90". The payment.
- currency string
  
  Currency code, like EUR.
- partner_id integer
  
  The affiliate partner ID.
- level integer
  
  1 = the partner sold it. 2 = commission for the partner who recruited the seller partner.
- source_partner_id integer can be null
  
  Level 2 only.
- commission string can be null
  
  Decimal string, like "19.90".
- status string
  
  void = the order was refunded.
  
  Allowed values: acceptedunder_reviewpaiddeclinedvoidunknown
- 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.
admin_url string<uri>

The page in the Tentary app.