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

> ## Agent Instructions
> Reconify's API reference is read-only for customer data. Do not invent endpoints or authentication behavior beyond the OpenAPI contract.
> The public OpenAPI document contains only the external /v1 contract. Dashboard business routes are intentionally excluded.

# List issues

> Lists evidence-backed monitoring issues for the organization.



## OpenAPI

````yaml /openapi/reconify.openapi.json get /v1/issues
openapi: 3.1.0
info:
  description: Public event ingestion and issue operations for Reconify.
  title: Reconify API
  version: 1.0.0
servers:
  - description: Reconify API root
    url: https://api.reconifyhq.com
security: []
tags:
  - description: Submit events through the public v1 ingestion API.
    name: Event Ingestion API
  - description: Public API metadata and health checks.
    name: API Metadata
  - description: Read received events and evidence linked to issues.
    name: Event Reads
  - description: Discover and coordinate evidence-backed monitoring issues.
    name: Issue Operations
  - description: Read organization details and assignable member IDs.
    name: Organization
paths:
  /v1/issues:
    get:
      tags:
        - Issue Operations
      summary: List issues
      description: Lists evidence-backed monitoring issues for the organization.
      operationId: list-issues
      parameters:
        - description: Filter by finding status.
          in: query
          name: status
          required: false
          schema:
            enum:
              - open
              - resolved
              - resolved_late
            type: string
        - description: Number of records to return.
          in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 100
            minimum: 1
            type: integer
        - description: Opaque cursor returned by the previous response.
          in: query
          name: after
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                issues:
                  - category: missing_event
                    id: 00000000-0000-7000-8000-000000000001
                    message: Payment flow is missing wallet credit evidence
                    opened_at: '2026-01-01T00:00:00Z'
                    severity: medium
                    status: open
                limit: 50
              schema:
                $ref: '#/components/schemas/ListIssuesResponse'
          description: OK
        '400':
          content:
            application/json:
              example:
                code: invalid_input
                message: request is invalid
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              example:
                code: unauthorized
                message: authentication required
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized
        '403':
          content:
            application/json:
              example:
                code: forbidden
                message: credential cannot access this organization
              schema:
                $ref: '#/components/schemas/Error'
          description: Forbidden
        '404':
          content:
            application/json:
              example:
                code: not_found
                message: resource not found
              schema:
                $ref: '#/components/schemas/Error'
          description: Not Found
        '503':
          content:
            application/json:
              example:
                code: database_unavailable
                message: public API data is unavailable
              schema:
                $ref: '#/components/schemas/Error'
          description: Service Unavailable
      security:
        - organizationApiKey: []
components:
  schemas:
    ListIssuesResponse:
      properties:
        issues:
          description: Issues returned in descending opened-at order.
          items:
            $ref: '#/components/schemas/Issue'
          type: array
        limit:
          description: Page size used for this response.
          minimum: 1
          type: integer
        next_cursor:
          description: Opaque cursor for the next page, when available.
          type: string
      required:
        - issues
        - limit
      type: object
    Error:
      properties:
        code:
          description: Stable machine-readable error code.
          type: string
        detail:
          description: Human-readable details about the request failure.
          type: string
        message:
          description: Short human-readable explanation.
          type: string
        status:
          description: HTTP status code for the problem.
          type: integer
        title:
          description: General category of the problem.
          type: string
      type: object
    Issue:
      properties:
        assigned_to:
          description: User ID of the assigned organization member.
          type:
            - string
            - 'null'
        category:
          description: Deterministic reason the finding was raised.
          enum:
            - business_failure
            - missing_event
            - mismatch
            - duplicate_or_conflict
          type: string
        id:
          description: Stable issue identifier.
          type: string
        message:
          description: Evidence-backed explanation of the issue.
          type: string
        opened_at:
          description: When the issue was opened.
          format: date-time
          type: string
        operation_id:
          description: Related monitored operation identifier.
          type:
            - string
            - 'null'
        resolved_at:
          description: When the issue was resolved, if applicable.
          format: date-time
          type:
            - string
            - 'null'
        severity:
          description: Public severity classification.
          enum:
            - high
            - medium
          type: string
        status:
          description: Current monitoring finding state.
          enum:
            - open
            - resolved
            - resolved_late
          type: string
      required:
        - id
        - status
        - category
        - severity
        - message
        - opened_at
      type: object
  securitySchemes:
    organizationApiKey:
      description: Organization API key. Use a write-scoped key for event ingestion.
      scheme: bearer
      type: http

````