---
title: "List tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# List tags

`GET /tags`

## Query parameters

- `business_entity_id` string, required
- `tag_group_id` string
- `include_archived` boolean
- `archived_at` object
- `expand` string[]

## Response `200`

OK

- object
  - `object` string — The type of the object in Nmbr (`"list"`).
  - `data` object[]
    - `id` string — The unique identifier of the object in Nmbr.
    - `object` string — The type of the object in Nmbr (`"tag"`).
    - `data` Tag
      - `label` string
      - `label_translations` Translations, nullable
        - `en` string
        - `fr` string
      - `label_translated` string — The translation of the `label` property for the request locale. Computed using the values in `label` and `label_translations` and the value of the request's `Accept-Language` header.
      - `description` string, nullable
      - `description_translations` Translations, nullable
        - `en` string
        - `fr` string
      - `description_translated` string — The translation of the `description` property for the request locale. Computed using the values in `description` and `description_translations` and the value of the request's `Accept-Language` header.
      - `archived_at` string, dateTime, nullable — When set, the tag is archived and excluded from index listings by default.
      - `is_deletable` boolean — A tag may not be deleted while it is assigned to any active allocation.
      - `expense_segment` string, nullable — The expense code piece this tag contributes to a generated expense code, pulled in by a `tag_group` segment of an accounting code rule's expense template.
      - `liability_segment` string, nullable — The liability code piece this tag contributes to a generated liability code, pulled in by a `tag_group` segment of an accounting code rule's liability template.
      - `integrations` object, nullable — Identifiers for this tag in external accounting integrations, used to sync tags imported from those systems.
        - `xero` object, nullable
          - `id` string — The unique identifier of the object in Nmbr.
        - `quickbooks` object, nullable
          - `id` string — The unique identifier of the object in Nmbr.
      - `tag_group` object
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"tag_group"`).
      - `business_entity` object
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"business_entity"`).
      - `created_at` string, dateTime — The date and time the object was created in Nmbr.
      - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

## Changes

> 18 revisions in range; 14 could not be searched.

- **2026-07-31** `7c45252e3e56` — 2 info
  - added the optional property `data/items/data/allOf[subschema #1: Tag]/expense_template_code` to the response with the `200` status
  - added the optional property `data/items/data/allOf[subschema #1: Tag]/liability_template_code` to the response with the `200` status

[Change history](https://skmtc.dev/nmbr/apis/nmbr-api/changes/tags/get.md)

---

[API](https://skmtc.dev/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.dev/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/29c2d6ac7131/schema)