Legal texts · Tentary API Reference

Legal texts

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

The legal texts of the shop as HTML, with the documents that the country of the account needs:

terms
cancellation: the cancellation policy in the EU, the return and refund policy in other countries
privacy
imprint: the Impressum in Germany, Austria and Switzerland, contact information in other countries

filled means the text is not empty. Buyers see the legal texts in the shop footer and at checkout.

Reads only MCP tool get_legal_texts

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

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

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

200 · Response

{
  "country": "DE",
  "documents": [
    {
      "document": "terms",
      "title": "Terms of service",
      "filled": true,
      "html": "<h2>Terms of service</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "cancellation",
      "title": "Cancellation policy",
      "filled": true,
      "html": "<h2>Cancellation policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "privacy",
      "title": "Privacy policy",
      "filled": true,
      "html": "<h2>Privacy policy</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    },
    {
      "document": "imprint",
      "title": "Legal notice (Impressum)",
      "filled": true,
      "html": "<h2>Impressum</h2><p>Lena Berg Yoga, Lindenstrasse 12, 10969 Berlin, Germany.</p>"
    }
  ],
  "attach_terms_to_order_emails": true,
  "admin_url": "https://app.tentary.com/settings/legal",
  "shop_url": "https://shop.tentary.com/legal/61326/tos"
}

Authorization

Authorization string header required

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

Response

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

country string

Seller country, like DE. It decides which documents the shop needs.
documents array of object

The legal documents for the seller country.
Show 4 fields Hide fields
- document string
  
  terms, cancellation, privacy or imprint.
  
  Allowed values: termscancellationprivacyimprint
- title string
  
  Name of the document for the seller country.
- filled boolean
  
  true = the text is not empty.
- html string
  
  The text as HTML.
attach_terms_to_order_emails boolean

true = the terms and the cancellation policy go as a PDF with every order e-mail.
admin_url string<uri>

The page in the Tentary app.
shop_url string<uri>

The terms in the shop.