# Thanx API

> Thanx restaurant ordering menus, categories with items and item modifiers

- Vendor: `thanxapi` · version 1.0 · category Food · tags thanx api, thanx menu api, restaurant ordering api, thanx online ordering api, restaurant menu api, menu modifiers api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/thanxapi
- This document: https://apiclay.com/docs/thanxapi.md
- OpenAPI 3.1: https://apiclay.com/api/thanxapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `thanxapi`
- Updated: 2026-11-18

## About

## Thanx API

Read the online-ordering menus of restaurants that use Thanx: the menus of a location, every category with its items and prices, and the modifier groups of any item.

Data comes from **thanx.com** (https://www.thanx.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged.

Typical flow: `/menus` -&gt; `/categories` -&gt; `/customizations`

Every route needs the merchant handle in the `Thanx-Merchant` header: the first path part of the merchant's Thanx ordering URL (e.g. `tacodeli`).

### Routes

#### GET `/menus` - Menus (menus of a location)
Returns the menus available at one location.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| location_id | query | string | yes | Thanx location id. |
| Thanx-Merchant | header | string | yes | Merchant handle, e.g. `tacodeli`. |

Returns (fields read by the source code; not yet verified live):
- `menus[].id`: menu id, the `menu_id` for `/categories`

#### GET `/categories` - Categories (categories and items of a menu)
Returns every category of a menu with its items, including hidden and unavailable ones.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| menu_id | path | string | yes | `menus[].id` from `/menus`. |
| Thanx-Merchant | header | string | yes | Merchant handle, e.g. `tacodeli`. |

Returns (fields read by the source code; not yet verified live):
- `categories[].id`, `.name`: category
- `categories[].items[].id`, `.name`, `.description`, `.price`: item (price in dollars)
- `categories[].items[].images.2x.desktop-menu`, `.images.3x.desktop-menu`: item images

#### GET `/customizations` - Customizations (modifiers of an item)
Returns the modifier groups of one item.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| item_id | path | string | yes | Item `id` from `/categories`. |
| Thanx-Merchant | header | string | yes | Merchant handle, e.g. `tacodeli`. |

Returns (fields read by the source code; not yet verified live):
- `modifiers[].id`, `.name`, `.required`, `.min_selections`, `.max_selections`: modifier group
- `modifiers[].options[].id`, `.name`, `.price`, `.max_quantity`: option (price in dollars)
- `modifiers[].options[].modifiers`: nested modifier groups

### Caveats

- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- The source site uses bot protection (Cloudflare); calls may be blocked until that is handled.
- These routes were translated from working client code but have not yet been called through ApiClay. Expect adjustments once they are tested.
- Not affiliated with thanx.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /menus — Menus (menus of a location)
- Gateway: `GET https://api.apiclay.com/v1/api/thanxapi/menus`
- Public headers: `Thanx-Merchant` (required)
- Public query params: `location_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories (categories and items of a menu)
- Gateway: `GET https://api.apiclay.com/v1/api/thanxapi/categories`
- Public headers: `Thanx-Merchant` (required)
- Public query params: `menu_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /customizations — Customizations (modifiers of an item)
- Gateway: `GET https://api.apiclay.com/v1/api/thanxapi/customizations`
- Public headers: `Thanx-Merchant` (required)
- Public query params: `item_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/thanxapi/menus?location_id=<location_id>" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Thanx-Merchant: <THANX_MERCHANT>"
```

Index of every published API: https://apiclay.com/llms.txt
