---
title: "List transaction labels"
method: GET
path: "/v1/transaction_labels"
tags: ["Transaction label"]
---

# List transaction labels

`GET /v1/transaction_labels`

Returns a paginated list of transaction labels available to the caller, scoped to the
caller's company (members with owner/admin/finance/member roles). Labels are company-scoped
tags that can be associated with transactions.

## Query parameters

- `_start` integer
- `_end` integer
- `_order` 'asc' | 'desc'
- `_field` string

## Headers

- `company-id` string, uuid, required

## Response `200`

Paginated list of labels

- TransactionLabel[]
  - `id` string, uuid, required
  - `label` string, required
  - `color` string, nullable
  - `company_id` string, uuid
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/cardda/apis/banking-api.md) · [All operations](https://skmtc.net/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cardda/banking-api/versions/ff1aeb3fda8b/schema)