> ## 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 issues for an organization

> Returns a paginated list of issues for the authenticated organization



## OpenAPI

````yaml /assets/openapi.mintlify.json get /issues
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:
    get:
      tags:
        - Issues
      summary: Fetch issues for an organization
      description: Returns a paginated list of issues for the authenticated organization
      operationId: listIssues
      parameters:
        - $ref: '#/components/parameters/AntimetalVersion'
        - name: limit
          required: false
          in: query
          description: Number of items to return (1-100)
          schema:
            minimum: 1
            maximum: 100
            default: 10
            type: integer
        - name: startingAfter
          required: false
          in: query
          description: Cursor for forward pagination (ID/UUID to start after)
          schema:
            type: string
        - name: endingBefore
          required: false
          in: query
          description: Cursor for backward pagination (ID/UUID to end before)
          schema:
            type: string
        - name: status
          required: false
          in: query
          description: Filter by issue status
          schema:
            type: string
            enum:
              - investigating
              - ready_to_fix
              - resolved
              - muted
        - name: environment
          required: false
          in: query
          description: Filter by environment (exact match)
          schema:
            minLength: 1
            type: string
        - name: search
          required: false
          in: query
          description: >-
            Search issues by title or description (case-insensitive substring
            match)
          schema:
            minLength: 1
            type: string
      responses:
        '200':
          description: Paginated list of issues
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/IssueSummaryDto'
                  has_more:
                    type: boolean
                  after:
                    type: string
                  before:
                    type: string
                required:
                  - object
                  - data
                  - has_more
        '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'
        '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
            });

            // Automatically fetches more pages as needed.
            for await (const issueListResponse of client.issues.list()) {
              console.log(issueListResponse.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:
    IssueSummaryDto:
      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: Event timestamp
        seedCount:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: Number of seeds for this issue
      required:
        - uuid
        - number
        - title
        - description
        - severity
        - status
        - environment
        - triggeredAt
        - seedCount
    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

````