> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superlog.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a trace

> Returns every span of one trace in start order, and the logs written during it.



## OpenAPI

````yaml /api-reference/openapi.json get /telemetry/traces/{traceId}
openapi: 3.1.0
info:
  description: >-
    Manage a Superlog workspace's automations, runs, tag mode, model access, and
    secrets, read its telemetry, build dashboards and alerts over it, run
    synthetic checks, and export them to Terraform. Every request acts as the
    member who created the API key.
  title: Superlog management API
  version: 1.0.0
servers:
  - url: https://superlog.sh/api/v1
security:
  - bearerAuth: []
tags:
  - description: Connected integrations and the IDs automations and tag mode use.
    name: Integrations
  - description: The workspace and its members.
    name: Workspace
  - description: Keys that authenticate the management API and MCP server.
    name: API keys
  - description: Create and change automations.
    name: Automations
  - description: Start, follow, and cancel automation runs.
    name: Runs
  - description: What Superlog can use and change when someone mentions it in Slack.
    name: Tag mode
  - description: Model API keys, subscriptions, and available models.
    name: Models
  - description: Credentials agents can use without seeing them.
    name: Secrets
  - description: Read the workspace's logs, traces, and metrics.
    name: Telemetry
  - description: >-
      Exceptions in the workspace's telemetry, grouped into issues by
      fingerprint.
    name: Errors
  - description: Create and change dashboards over the workspace's telemetry.
    name: Dashboards
  - description: Threshold alerts on the workspace's telemetry that post to Slack.
    name: Alerts
  - description: HTTP checks that request a URL on a schedule and post failures to Slack.
    name: Synthetics
  - description: Configuration for the superloglabs/superlog Terraform provider.
    name: Terraform
paths:
  /telemetry/traces/{traceId}:
    get:
      tags:
        - Telemetry
      summary: Get a trace
      description: >-
        Returns every span of one trace in start order, and the logs written
        during it.
      operationId: get_trace
      parameters:
        - description: A 32-character hexadecimal trace ID.
          in: path
          name: traceId
          required: true
          schema:
            type: string
            pattern: ^[0-9a-fA-F]{32}$
            description: A 32-character hexadecimal trace ID.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  logs:
                    type: array
                    items:
                      type: object
                      properties:
                        attributes:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties:
                            type: string
                        body:
                          type: string
                        exception:
                          anyOf:
                            - type: object
                              properties:
                                message:
                                  type: string
                                stacktrace:
                                  type: string
                                type:
                                  type: string
                              required:
                                - message
                                - stacktrace
                                - type
                              additionalProperties: false
                            - type: 'null'
                          description: The recorded exception, when there is one.
                        resourceAttributes:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties:
                            type: string
                        service:
                          type: string
                        severity:
                          type: string
                        severityNumber:
                          anyOf:
                            - type: number
                            - type: 'null'
                        spanId:
                          type: string
                        timestamp:
                          type: string
                          description: UTC.
                        traceId:
                          type: string
                      required:
                        - attributes
                        - body
                        - exception
                        - resourceAttributes
                        - service
                        - severity
                        - severityNumber
                        - spanId
                        - timestamp
                        - traceId
                      additionalProperties: false
                  spans:
                    type: array
                    items:
                      type: object
                      properties:
                        attributes:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties:
                            type: string
                        durationMs:
                          type: number
                        exception:
                          anyOf:
                            - type: object
                              properties:
                                message:
                                  type: string
                                stacktrace:
                                  type: string
                                type:
                                  type: string
                              required:
                                - message
                                - stacktrace
                                - type
                              additionalProperties: false
                            - type: 'null'
                          description: The recorded exception, when there is one.
                        kind:
                          type: string
                        name:
                          type: string
                        parentSpanId:
                          type: string
                        resourceAttributes:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties:
                            type: string
                        service:
                          type: string
                        spanId:
                          type: string
                        statusCode:
                          type: string
                        statusMessage:
                          type: string
                        timestamp:
                          type: string
                          description: Span start, UTC.
                        traceId:
                          type: string
                      required:
                        - attributes
                        - durationMs
                        - exception
                        - kind
                        - name
                        - parentSpanId
                        - resourceAttributes
                        - service
                        - spanId
                        - statusCode
                        - statusMessage
                        - timestamp
                        - traceId
                      additionalProperties: false
                required:
                  - logs
                  - spans
                additionalProperties: false
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The request is invalid. `issues` lists each invalid field.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The API key is missing, revoked, or its creator left the workspace.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            The resource does not exist in this workspace, or the feature it
            belongs to is not enabled.
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        code:
          description: A stable machine-readable error code, when there is one.
          type: string
        error:
          type: string
          description: What went wrong.
        issues:
          description: Validation problems, one per invalid field.
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              path:
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: number
            required:
              - message
              - path
            additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      description: A workspace API key, created in Superlog under Settings → API keys.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.