---
title: "Get a project trace by request ID"
method: GET
path: "/v1/projects/traces"
tags: ["projects"]
---

# Get a project trace by request ID

`GET /v1/projects/traces`

Returns the OTEL trace for a given Vercel CLI request.

## Query parameters

- `projectId` string, required — The project ID
- `requestId` string, required — The Vercel CLI request ID associated with the trace
- `teamId` string
- `slug` string

## Response `200`

- object
  - `trace` object, required
    - `traceId` string, required
    - `resources` object[]
      - `name` string, required
      - `attributes` object, required
    - `spans` object[], required
      - `name` string, required
      - `kind` number, required
      - `resource` string, required
      - `library` object, required
        - `name` string, required
        - `version` string
      - `spanId` string, required
      - `parentSpanId` string
      - `status` object, required
        - `code` number, required
        - `message` string
      - `traceState` string
      - `traceFlags` number, required
      - `attributes` object, required
      - `links` object[], required
      - `events` object[], required
        - `name` string, required
        - `timestamp` union[], required
          - union
            - number
            - number
        - `attributes` object, required
      - `startTime` union[], required
        - union
          - number
          - number
      - `endTime` union[], required
        - union
          - number
          - number
      - `duration` union[], required
        - union
          - number
          - number
    - `rootSpanId` string

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `410`

---

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