---
title: "Get Tokenomics V1 Canonical User"
method: POST
path: "/tokenomics/v1/canonical-users/{user_key}"
tags: ["tokenomics"]
---

# Get Tokenomics V1 Canonical User

`POST /tokenomics/v1/canonical-users/{user_key}`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/tokenomics/v1/canonical-users/{user_key}`
- Auth: one of:
  - API key in header `Splunk-AO-API-Key`
  - API key in header `Galileo-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic

## Path parameters

- `user_key` string, required

## Request body

- TokenomicsCanonicalUserRequest
  - `filters` TokenomicsCanonicalUserFilters: Usage and leadership filters that also affect exact-user table rows.
    - `time_range` TokenomicsTimeRange
      - `start_date` string, date, required
      - `end_date` string, date, required
    - `providers` string[], nullable
    - `models` string[], nullable
    - `leader_user_key` string, nullable
  - `view` 'individual' | 'team' | 'organization', nullable
  - `by_model` boolean

## Response `200`

Successful Response

- TokenomicsCanonicalUsersResponse
  - `date_range` TokenomicsDateRange, required
    - `start_date` string, date, required
    - `end_date` string, date, required
  - `directory` TokenomicsDirectorySnapshot, required
    - `directory_generation_id` string, uuid4, required
    - `import_id` string, uuid4, required
    - `imported_at` string, date-time, required
  - `data_freshness` TokenomicsDataFreshnessV1, required
    - `usage_updated_at` string, date-time, nullable
    - `adoption_updated_at` string, date-time, nullable
  - `users` TokenomicsCanonicalUserRow[], required
    - `user_key` string, required
    - `manager_user_key` string, nullable
    - `manager_display_name` string, nullable
    - `display_name` string, nullable
    - `primary_email` string, nullable
    - `department` string, nullable
    - `job_function` string, nullable
    - `job_family` string, nullable
    - `region` string, nullable
    - `is_active` boolean, required
    - `last_active_at` string, date-time, nullable
    - `usage_cost_usd` number, nullable
    - `total_tokens` integer, nullable
    - `cost_data_status` 'complete' | 'partial' | 'unavailable', required
    - `provider_breakdown` TokenomicsCanonicalUserProviderBreakdown[], required
      - `provider` string, required
      - `is_active` boolean, required
      - `last_active_at` string, date-time, nullable
      - `usage_cost_usd` number, nullable
      - `total_tokens` integer, nullable
      - `cost_data_status` 'complete' | 'partial' | 'unavailable', nullable
      - `accounts` TokenomicsProviderAccountRef[]
        - `provider_user_id` string, nullable
        - `user_email` string, nullable
      - `model_breakdown` TokenomicsCanonicalUserModelBreakdown[], nullable
        - `model` string, required
        - `usage_cost_usd` number, nullable
        - `total_tokens` integer, nullable
  - `unmatched` TokenomicsUnmatchedSummary
    - `account_count` integer, required
    - `usage_cost_usd` number, nullable
    - `total_tokens` integer, nullable
  - `pagination` TokenomicsUsersPagination, required
    - `limit` integer, required
    - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 2 not diffed.

- **2026-10-26** `a289cea1b504`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/tokenomics/v1/canonical-users/:user_key/post.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/4cf49e96b632?raw)