# Landing pages

`GET https://api.tentary.com/v1/landing-pages`

Source: https://tentary.com/en/help/api/list-landing-pages/
Area: Landing pages
MCP tool: `list_landing_pages`. Reads only. Changes nothing in the account.

---

The landing pages of the account, newest first: title, type, status, URL and admin link.

- `type` `html`: a page from your own HTML code.
- `type` `builder`: a page made with the page builder in the app.
- A draft page is not public. Its URL opens the shop.

For the HTML of an `html` page, call [`GET /v1/landing-pages/{page_id}`](https://tentary.com/en/help/api/get-landing-page/).

## Authorization

`Authorization: Bearer <API key>`

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

## Query parameters

- `cursor` (string, query): 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, query): Items per page, default 25. Limits: min 1, max 50.

## Response

- `landing_pages` (array of object): Newest first.
  - `id` (integer): The ID.
  - `title` (string): Name in the Tentary app.
  - `type` (string): html = own HTML code. builder = made with the page builder in the app. Allowed values: `html`, `builder`.
  - `status` (string): draft = not public: its URL opens the shop. Allowed values: `live`, `draft`.
  - `url_slug` (string): The address part of the URL.
  - `url` (string<uri>): shop URL/<url_slug>.
  - `affiliates` (boolean): true = shown to the affiliates in their affiliate hub.
  - `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.
  - `landing_pages` (string<uri>): Page in the Tentary app.

## Example request

```bash
curl "https://api.tentary.com/v1/landing-pages" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "landing_pages": [
    {
      "id": 901,
      "title": "Retreat 2027",
      "type": "html",
      "status": "live",
      "url_slug": "retreat-2027",
      "url": "https://lena-yoga.mytentary.com/retreat-2027",
      "affiliates": false,
      "created_at": "2026-10-22T10:00:00Z",
      "admin_url": "https://app.tentary.com/landingpages/edit-html/901"
    }
  ],
  "next_cursor": null,
  "links": {
    "landing_pages": "https://app.tentary.com/landingpages"
  }
}
```
