---
title: "Get list of customer tags used by the store"
method: GET
path: "/customertags"
tags: ["CustomerTags"]
---

# Get list of customer tags used by the store

`GET /customertags`

## Request

- Base URL: `https://api.c1st.com/api`
- URL: `https://api.c1st.com/api/customertags`
- Auth: HTTP bearer

## Query parameters

- `freetext` string: Search string
- `paginationStart` number: Start of pagination
- `paginationPageLength` number: Pagination page length

## Response `200`

Ok

- CustomerTagsResponse: The customer tags used by a store.
  - `content` CustomerTag[]
    - `title` string, required: The title of the tag
    - `id` integer, nullable: The id of the tag
    - `handle` string, nullable: Unique handle for the produttag. Will be set automatically if not set. This value cannot be changed once set.
    - `color` string, nullable: The color used when displaying the tag in the app
  - `count` integer, nullable: The total number of customer tags found
  - `hasMore` boolean: True if there are data to retrieve than the given page length

---

[API](https://skmtc.dev/c1st/apis/customers-1st-api.md) - [All operations](https://skmtc.dev/c1st/apis/customers-1st-api/llms.txt) - [OpenAPI document](https://skmtc.dev/c1st/apis/customers-1st-api/revisions/4250bb326f2a?raw)