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

# Fetch an issue by ID (UUID)

> Retrieves detailed information about a specific issue by its ID (UUID)



## OpenAPI

````yaml /assets/openapi.mintlify.json get /issues/{id}
openapi: 3.0.0
info:
  title: Antimetal External API
  description: >-
    Public-facing API for external integrations with Antimetal. Provides
    programmatic access to issue investigation, results, artifacts, and chat
    functionality.
  version: '2026-03-17'
  contact: {}
servers:
  - url: https://bff.antimetal.com/api/v2
    description: Production API
  - url: https://bff.dev.antimetal.com/api/v2
    description: Dev API
security:
  - bearer: []
tags: []
paths:
  /issues/{id}:
    get:
      tags:
        - Issues
      summary: Fetch an issue by ID (UUID)
      description: Retrieves detailed information about a specific issue by its ID (UUID)
      operationId: getIssue
      parameters:
        - $ref: '#/components/parameters/AntimetalVersion'
        - name: version
          required: false
          in: query
          description: Issue version (defaults to latest)
          schema:
            type: integer
            format: int32
            minimum: 1
        - name: id
          required: true
          in: path
          description: Issue unique identifier (UUID)
          schema:
            type: string
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      responses:
        '200':
          description: Issue details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssueDto'
        '400':
          description: Validation error or bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '403':
          description: Insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Antimetal from '@antimetal/sdk';


            const client = new Antimetal({
              apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted
            });


            const issue = await
            client.issues.retrieve('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');


            console.log(issue.uuid);
components:
  parameters:
    AntimetalVersion:
      name: Antimetal-Version
      in: header
      required: false
      description: >-
        The API version to use. Defaults to the latest stable version if
        omitted. Pin to the version string in this document's `info.version`
        field to opt into exactly this version's schema.
      schema:
        type: string
        example: '2026-03-17'
        default: '2026-03-17'
  schemas:
    IssueDto:
      type: object
      properties:
        uuid:
          type: string
          description: Issue unique identifier
        number:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          maximum: 9007199254740991
          description: Issue number (scoped per-organization)
        title:
          type: string
          description: Issue title
        description:
          type: string
          description: Issue description
        severity:
          type: string
          enum:
            - low
            - medium
            - high
          description: Issue severity level
        status:
          type: string
          enum:
            - investigating
            - ready_to_fix
            - resolved
            - muted
          description: Current issue status
        environment:
          description: Environment where issue occurred
          type: string
        triggeredAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: Earliest trigger time from seeds
        createdAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: Date and time the issue was created
        updatedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: Date and time the issue was last updated
        seedCount:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: Number of seeds for this issue
        seeds:
          type: array
          items:
            type: object
            properties:
              publicUuid:
                type: string
                format: uuid
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                description: UUID of the seed
              seedType:
                type: string
                enum:
                  - alert
                  - user_query
                description: Type of seed (alert, user_query, etc.)
              provider:
                type: string
                enum:
                  - datadog
                  - github
                  - slack
                  - antimetal
                  - sentry
                  - kubernetes
                  - incident-io
                  - prometheus
                  - grafana-tempo
                  - loki
                  - gcp
                  - cloudwatch
                  - user
                description: Provider that generated this seed
              providerReferenceId:
                type: string
                description: Reference ID from the provider
              title:
                type: string
                description: Title of the seed
              description:
                type: string
                description: Description of the seed
              tags:
                type: array
                items:
                  type: string
                description: Tags associated with the seed
              link:
                description: Optional link related to the seed
                nullable: true
                type: string
              query:
                description: Optional query related to the seed
                nullable: true
                type: string
              rawPayload:
                description: Raw payload data from the provider
                nullable: true
                type: object
                additionalProperties: {}
              triggeredAt:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                description: Date and time the seed was triggered
            required:
              - publicUuid
              - seedType
              - provider
              - providerReferenceId
              - title
              - description
              - tags
              - triggeredAt
          description: Seeds associated with the issue
        latestVersion:
          type: integer
          minimum: 1
          maximum: 9007199254740991
          description: Most recent version of this issue
        versions:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                description: Version unique identifier
              version:
                type: integer
                minimum: 1
                maximum: 9007199254740991
              status:
                type: string
                enum:
                  - SUCCESS
                  - NOOP
                  - ERROR
                  - PENDING
                description: Conclusion status of this version
              description:
                description: Description of the changes in the version
                type: string
            required:
              - uuid
              - version
              - status
          description: Available versions of the issue
      required:
        - uuid
        - number
        - title
        - description
        - severity
        - status
        - environment
        - triggeredAt
        - createdAt
        - updatedAt
        - seedCount
        - seeds
        - latestVersion
        - versions
    ErrorResponseDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - api_error
            - invalid_request_error
            - authentication_error
          description: Error type classification
        message:
          type: string
          description: Human-readable error message
        request_id:
          type: string
          description: Request correlation ID for tracing and support
        details:
          description: Detailed field-level validation errors (for 400/422 responses)
          type: object
          additionalProperties:
            type: string
      required:
        - type
        - message
        - request_id
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key authentication via Bearer token

````