Meisei

    Customer tags

    GET /customer-tags

    List the tags your customers carry, alphabetically by default, with how many customers carry each. A tag exists only while a customer carries it: tag a customer to create one, and use the bulk update to rename or remove one. Supports filtering and cursor pagination.

    Requires the customers:read permission.

    Query parameters

    limitnumber

    The number of records to return.

    cursorstring

    A pagination cursor. Fetch the next page by passing the nextCursor value from the previous response.

    sortname | -name | customersCount | -customersCount | createdAt | -createdAt

    The sort order. Prefix a field with - to sort descending. Defaults to name.

    filterstring

    A JSON-encoded filter document, for example {"createdAt":{"$gte":"2025-01-01T00:00:00Z"}}. Filterable fields: name, createdAt. See Filtering for the syntax.

    Request
    curl \
  "https://your-store.meisei.app/api/customer-tags" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY"
    Response
    {
  "data": [
    {
      "name": "string",
      "customersCount": 0,
      "createdAt": "2025-01-15T09:30:00Z"
    }
  ],
  "nextCursor": "string"
}