---
title: "Get Activity Codes"
method: GET
path: "/v1/activity-codes"
tags: ["activity-codes"]
---

# Get Activity Codes

`GET /v1/activity-codes`

## Request

- Base URL: `https://app.tokumalabs.com/api`
- URL: `https://app.tokumalabs.com/api/v1/activity-codes`
- Auth: OAuth 2
  - Password
  - Token URL: `v1/auth/token`

Get all available activity codes.

Returns all UTBMS activity codes available for time tracking and billing.
This is reference data but requires authentication.

## Response `200`

Successful Response

- ActivityCodesResponse: Response model for activity codes list.
  - `activity_codes` ActivityCodeDto[], required: List of available activity codes
    - `id` string, required: Activity code ID
    - `name` string, required: Activity code name
    - `description` string, required: Activity code description
    - `order` integer, required: Display order of the activity code

## Other responses

- `400`: Validation error or domain rule violation.
- `401`: Missing, expired, or invalid authentication.
- `403`: Authenticated but not permitted.
- `404`: Resource not found.
- `409`: Resource state conflict (duplicate, illegal transition).
- `422`: Request body failed schema validation.
- `500`: Server-side failure.

---

[API](https://skmtc.dev/tokumalabs/apis/tokuma-user-api.md) - [All operations](https://skmtc.dev/tokumalabs/apis/tokuma-user-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tokumalabs/apis/tokuma-user-api/revisions/1f8201af459b?raw)