---
title: "List all merge tags"
method: GET
path: "/merge-tags"
tags: ["MergeTags"]
---

# List all merge tags

`GET /merge-tags`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/merge-tags`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/merge-tags/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all [merge tags](#tag/merge_tag) for your company.

## Query parameters

- `page` integer
- `per_page` integer
- `filter[name]` string
- `filter[platform_id]` string

## Response `200`

OK

- MergeTagList
  - `data` MergeTag[]
    - `type` string
    - `id` string
    - `attributes` MergeTagAttributes
      - `id` string
      - `name` string
      - `description` string
      - `is_special_link` boolean
      - `platform_id` string
      - `merge_tag_value` string
      - `velocity_script_token` string, nullable
      - `knak_tag` string: A paste-ready merge-tag token you can embed directly in asset content. Knak resolves it to the correct platform merge tag when the asset is synced. See the [Merge Tag Model](#tag/merge_tag) for the content syntax.
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` object[]
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)