Products and files

Products

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 / products

The products of the account, newest first: name, type, status, price, billing, number of sales, shop link and admin link.

price is the normal price. current_price is what buyers pay now: a running limited offer replaces the price.
sales counts paid orders and orders in payment of all time, refunded and free orders included. paid_sales counts only orders with an amount above 0.
Without status, the list has live and draft products. Archived products are deleted products.
Prices are in the account currency.

For texts, images, files, variants and the linked course, call GET /v1/products/{product_id}.

Reads only MCP tool list_products

curl "https://api.tentary.com/v1/products?status=live&limit=2" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

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

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

200 · Response

{
  "currency": "EUR",
  "products": [
    {
      "id": 103,
      "name": "Yoga Club",
      "type": "link",
      "status": "live",
      "price": "19.00",
      "current_price": "19.00",
      "price_is_from": false,
      "billing": "subscription",
      "billing_interval_months": 1,
      "hide_in_shop": false,
      "sales": 1,
      "paid_sales": 1,
      "url": "https://lena-yoga.mytentary.com/p/yoga-club",
      "checkout_url": "https://lena-yoga.mytentary.com/p/yoga-club/checkout",
      "admin_url": "https://app.tentary.com/products/edit/103"
    },
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days",
      "type": "course",
      "status": "live",
      "price": "49.00",
      "current_price": "39.00",
      "price_is_from": false,
      "billing": "one_time",
      "billing_interval_months": null,
      "hide_in_shop": false,
      "sales": 1,
      "paid_sales": 1,
      "url": "https://lena-yoga.mytentary.com/p/morning-yoga",
      "checkout_url": "https://lena-yoga.mytentary.com/p/morning-yoga/checkout",
      "admin_url": "https://app.tentary.com/products/edit/102"
    }
  ],
  "next_cursor": "aWQ6MTAy",
  "links": {
    "products": "https://app.tentary.com/products"
  }
}

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

type string

Only products of this type.

Allowed values: downloadlinknewsletterbookingcoursebundleexternal
status string

Only products with this status.

Allowed values: livedraftarchived

Example: "live"
query string

Part of the product name.

max length 100
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 Example: 2

Response

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

currency string

Currency code, like EUR. Prices are in this currency.
products array of object

Newest first.
Show 15 fields Hide fields
- id integer
  
  The ID.
- name string
  
  Product name.
- type string
  
  The type.
  
  Allowed values: downloadlinknewsletterbookingcoursebundleexternal
- status string
  
  archived = deleted.
  
  Allowed values: livedraftarchived
- price string
  
  Decimal string, like "19.90". Normal price.
- current_price string
  
  Decimal string, like "19.90". What buyers pay now: a running limited offer replaces the price.
- price_is_from boolean
  
  true = the product has variants and price is the lowest variant price.
- billing string
  
  How the buyer pays: one_time, subscription or installments.
  
  Allowed values: one_timesubscription
- billing_interval_months integer can be null
  
  Subscription: months between payments.
- hide_in_shop boolean
  
  true = not shown on the shop page.
- sales integer
  
  Paid orders and orders in payment of all time, refunded and free orders included.
- paid_sales integer
  
  Orders with an amount above 0.
- url string<uri>
  
  Sales page.
- checkout_url string<uri> can be null
  
  Checkout page. Only for live products.
- admin_url string<uri>
  
  The product 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 1 field Hide fields
- products string<uri>
  
  Page in the Tentary app.