---
title: "Retrieves a list of traces for the authenticated user"
method: GET
path: "/api/v1/context/traces"
tags: ["traces"]
---

# Retrieves a list of traces for the authenticated user

`GET /api/v1/context/traces`

Returns paginated traces for the authenticated user within their organization.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved traces

- object
  - `traces` object[], required
    - `_id` string, required
    - `userId` string, required
    - `organizationId` string, required
    - `type` string, required
    - `data` object, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
    - `hasNextPage` boolean, required
    - `hasPrevPage` boolean, required

## Other responses

- `401` — Unauthorized - User or organization not found
- `402` — Unauthorized - Invalid user
- `403` — Forbidden - User lacks required scope
- `500` — Internal Server Error

## Changes

- **2026-01-03** `510cbb709bed` — 20 info
  - api tag `traces` added
  - api tag `Traces` removed
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `page`
  - …16 more
- **2025-12-24** `3f676384b4bb` — 1 info
  - api operation id `viewRawContextTracesForUser` was added
- **2025-09-18** `38251f330bf6` — 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
- **2025-09-18** `27487dadb0ef` — 2 info
  - the endpoint scheme security `BearerAuth` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2025-09-18** `a2083e2f1a72` — 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API

[Change history](https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/changes/api/v1/context/traces/get.md)

---

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