Meisei

    Order tags

    GET /order-tags

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

    Requires the orders: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 | ordersCount | -ordersCount | 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/order-tags" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY"
    Response
    {
  "data": [
    {
      "name": "string",
      "ordersCount": 0,
      "createdAt": "2025-01-15T09:30:00Z"
    }
  ],
  "nextCursor": "string"
}