Atla SDK API

The SDK API from Atla — 3 operation(s) for sdk.

Operations 3

GET /api/sdk/v1/traces List traces with pagination and filtering #
GET /api/sdk/v1/traces/ids Get multiple traces by IDs #
GET /api/sdk/v1/traces/{traceId} Get a single trace by ID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/atla-sdk-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

atla-sdk-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Atla Insights SDK API
  description: Development documentation
  version: 1.0.0
servers:
- url: https://app.atla-ai.com
  description: API server
tags:
- name: SDK
paths:
  /api/sdk/v1/traces:
    get:
      responses:
        '200':
          description: Successfully retrieved paginated list of traces
          content:
            application/json:
              schema:
                type: object
                properties:
                  traces:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        environment:
                          type: string
                          enum:
                          - PROD
                          - DEV
                        isSuccess:
                          type:
                          - boolean
                          - 'null'
                        isCompleted:
                          type: boolean
                        metadata:
                          type:
                          - object
                          - 'null'
                          additionalProperties:
                            type: string
                        startedAt:
                          type: string
                        endedAt:
                          type: string
                      required:
                      - id
                      - environment
                      - isSuccess
                      - isCompleted
                      - startedAt
                      - endedAt
                  total:
                    type: number
                  page:
                    type: integer
                  pageSize:
                    type: integer
                required:
                - traces
                - total
                - page
                - pageSize
        '401':
          description: Unauthorized - Invalid or missing API key
        '500':
          description: Internal server error
      operationId: listTraces
      tags:
      - SDK
      parameters:
      - in: query
        name: startTimestamp
        schema:
          type: string
          format: date-time
      - in: query
        name: endTimestamp
        schema:
          type: string
          format: date-time
      - name: metadataFilter
        in: query
        required: false
        description: 'URL-encoded JSON array of metadata key-value pairs: [{"key":"version","value":"1"}]'
        schema:
          type: string
      - in: query
        name: page
        schema:
          type: integer
          minimum: 1
          default: 1
      - in: query
        name: pageSize
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 50
      summary: List traces with pagination and filtering
      description: Retrieve a paginated list of traces for the authenticated organization.
      security:
      - bearerAuth: []
      x-mint:
        metadata:
          title: Get Traces
          description: Get traces
        content: '

          Retrieve specific traces by providing an array of trace IDs.

          Returns complete trace data including spans, summaries, and custom

          metrics for all found traces.

          '
        href: /api-reference/get-traces
  /api/sdk/v1/traces/ids:
    get:
      responses:
        '200':
          description: Successfully retrieved traces matching the provided IDs
          content:
            application/json:
              schema:
                type: object
                properties:
                  traces:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        environment:
                          type: string
                          enum:
                          - PROD
                          - DEV
                        isSuccess:
                          type:
                          - boolean
                          - 'null'
                        isCompleted:
                          type: boolean
                        metadata:
                          type:
                          - object
                          - 'null'
                          additionalProperties:
                            type: string
                        stepCount:
                          type: integer
                        startedAt:
                          type: string
                        endedAt:
                          type: string
                        durationSeconds:
                          type: number
                        ingestedAt:
                          type: string
                        spans:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              traceId:
                                type: string
                              parentSpanId:
                                type:
                                - string
                                - 'null'
                              spanName:
                                type:
                                - string
                                - 'null'
                              startTimestamp:
                                type: string
                              endTimestamp:
                                type: string
                              isException:
                                type:
                                - boolean
                                - 'null'
                              otelEvents:
                                type: array
                                items: {}
                              annotations:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    spanId:
                                      type: string
                                    failureMode:
                                      type: string
                                    atlaCritique:
                                      type: string
                                    id:
                                      type: string
                                  required:
                                  - spanId
                                  - failureMode
                                  - atlaCritique
                                  - id
                            required:
                            - id
                            - traceId
                            - parentSpanId
                            - spanName
                            - startTimestamp
                            - endTimestamp
                            - isException
                            - otelEvents
                        customMetricValues:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              traceId:
                                type: string
                              customMetricId:
                                type: string
                              value:
                                type: string
                              customMetric:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  dataType:
                                    type: string
                                    enum:
                                    - BOOLEAN
                                    - LIKERT_1_TO_5
                                required:
                                - id
                                - name
                                - dataType
                            required:
                            - id
                            - traceId
                            - customMetricId
                            - value
                      required:
                      - id
                      - environment
                      - isSuccess
                      - isCompleted
                      - stepCount
                      - startedAt
                      - endedAt
                      - durationSeconds
                      - ingestedAt
                required:
                - traces
        '401':
          description: Unauthorized - Invalid or missing API key
        '500':
          description: Internal server error
      operationId: getTracesByIds
      tags:
      - SDK
      parameters:
      - in: query
        name: ids
        schema:
          type: array
          items:
            type: string
        required: true
      - in: query
        name: include
        schema:
          type: array
          items:
            type: string
            enum:
            - spans
            - annotations
            - customMetrics
        required: false
      summary: Get multiple traces by IDs
      description: Retrieve specific traces by providing an array of trace IDs. Returns complete trace data including spans, summaries, and custom metrics for all found traces.
      x-mint:
        metadata:
          title: Get Multiple Traces by IDs
          description: Get multiple traces by IDs
        content: '

          Retrieve specific traces by providing an array of trace IDs. Returns complete trace data including spans, summaries, and custom metrics for all found traces.

          '
        href: /api-reference/get-traces-by-ids
      security:
      - bearerAuth: []
  /api/sdk/v1/traces/{traceId}:
    get:
      responses:
        '200':
          description: Successfully retrieved trace with complete data
          content:
            application/json:
              schema:
                type: object
                properties:
                  trace:
                    type: object
                    properties:
                      id:
                        type: string
                      environment:
                        type: string
                        enum:
                        - PROD
                        - DEV
                      isSuccess:
                        type:
                        - boolean
                        - 'null'
                      isCompleted:
                        type: boolean
                      metadata:
                        type:
                        - object
                        - 'null'
                        additionalProperties:
                          type: string
                      stepCount:
                        type: integer
                      startedAt:
                        type: string
                      endedAt:
                        type: string
                      durationSeconds:
                        type: number
                      ingestedAt:
                        type: string
                      spans:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            traceId:
                              type: string
                            parentSpanId:
                              type:
                              - string
                              - 'null'
                            spanName:
                              type:
                              - string
                              - 'null'
                            startTimestamp:
                              type: string
                            endTimestamp:
                              type: string
                            isException:
                              type:
                              - boolean
                              - 'null'
                            otelEvents:
                              type: array
                              items: {}
                            annotations:
                              type: array
                              items:
                                type: object
                                properties:
                                  spanId:
                                    type: string
                                  failureMode:
                                    type: string
                                  atlaCritique:
                                    type: string
                                  id:
                                    type: string
                                required:
                                - spanId
                                - failureMode
                                - atlaCritique
                                - id
                          required:
                          - id
                          - traceId
                          - parentSpanId
                          - spanName
                          - startTimestamp
                          - endTimestamp
                          - isException
                          - otelEvents
                      customMetricValues:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            traceId:
                              type: string
                            customMetricId:
                              type: string
                            value:
                              type: string
                            customMetric:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                dataType:
                                  type: string
                                  enum:
                                  - BOOLEAN
                                  - LIKERT_1_TO_5
                              required:
                              - id
                              - name
                              - dataType
                          required:
                          - id
                          - traceId
                          - customMetricId
                          - value
                    required:
                    - id
                    - environment
                    - isSuccess
                    - isCompleted
                    - stepCount
                    - startedAt
                    - endedAt
                    - durationSeconds
                    - ingestedAt
                required:
                - trace
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Trace not found or access denied
        '500':
          description: Internal server error
      operationId: getTraceById
      tags:
      - SDK
      parameters:
      - in: query
        name: include
        schema:
          type: array
          items:
            type: string
            enum:
            - spans
            - annotations
            - customMetrics
      - schema:
          type: string
        in: path
        name: traceId
        required: true
      summary: Get a single trace by ID
      description: Retrieve a specific trace by its unique identifier. Returns complete trace data including all spans, annotations, trace summary, and custom metric values.
      security:
      - bearerAuth: []
      x-mint:
        metadata:
          title: Get Trace
          description: Get a single trace by ID
        content: '

          Retrieve a specific trace by its unique identifier. Returns

          complete trace data including all spans, annotations, trace summary, and

          custom metric values.

          '
        href: /api-reference/get-trace
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication using Bearer token