---
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

---

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