> ## Documentation Index
> Fetch the complete documentation index at: https://help.mytruv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Transaction Categories

> List the standard catalog followed by the user's custom categories.



## OpenAPI

````yaml GET /v2/users/transactions/categories
openapi: 3.1.0
info:
  title: Truv Public API
  description: >
    Read-only API for personal access token (PAT) users.


    ## Authentication


    Authenticate with `Authorization: Bearer <token>`. Tokens have a `pat_`
    prefix

    and are generated in the Truv web app under Settings → API keys.


    ## Available Endpoints


    This API exposes a subset of read-only endpoints for retrieving financial
    data,

    account links, and user profile information.
  version: 1.0.0
servers:
  - url: https://api.mytruv.com
    description: Production
security:
  - BearerAuth: []
tags:
  - name: users
    description: User profile — read-only access to the authenticated user's profile.
  - name: financial-data
    description: >-
      Financial data — balances, transactions, income, spending, liabilities,
      and balance history.
  - name: links
    description: >-
      Account links — list connected financial institutions and payroll
      providers.
paths:
  /v2/users/transactions/categories:
    get:
      tags:
        - financial-data
      summary: List User Transaction Categories V2
      description: List the standard catalog followed by the user's custom categories.
      operationId: listUserTransactionCategories
      responses:
        '200':
          description: Distinct categories present on the user's transactions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionCategoriesResponse'
components:
  schemas:
    TransactionCategoriesResponse:
      properties:
        categories:
          items:
            $ref: '#/components/schemas/TransactionCategoryItem'
          type: array
          title: Categories
      type: object
      required:
        - categories
      title: TransactionCategoriesResponse
    TransactionCategoryItem:
      properties:
        slug:
          type: string
          title: Slug
          description: snake_case identifier suitable for API filters.
        display_name:
          type: string
          title: Display Name
          description: Human-readable label for display in clients.
        kind:
          $ref: '#/components/schemas/CategoryKind'
          description: >-
            Transaction sign this category may be assigned to: income (credits),
            expense (debits), or transfer (either). Clients filter the picker by
            the transaction's sign, showing transfer categories on both.
      type: object
      required:
        - slug
        - display_name
        - kind
      title: TransactionCategoryItem
      description: A category entry for the override picker.
    CategoryKind:
      type: string
      enum:
        - income
        - expense
        - transfer
      title: CategoryKind
      description: >-
        Which transaction sign a category may be assigned to.


        income categories belong on credits (inflows), expense on debits
        (outflows),

        and transfer on either (account movements, refunds, and user custom
        categories,

        which carry no inherent sign).
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: PAT
      description: >-
        Bearer authentication with a personal access token (prefix `pat_`).
        Generate tokens in the Truv web app under Settings → API keys.

````