> ## 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 issue evidence

> Lists events linked to an issue through its monitored operation.



## OpenAPI

````yaml /openapi/reconify.openapi.json get /v1/issues/{issue_id}/events
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/{issue_id}/events:
    get:
      tags:
        - Event Reads
      summary: List issue evidence
      description: Lists events linked to an issue through its monitored operation.
      operationId: list-issue-events
      parameters:
        - description: Issue identifier.
          in: path
          name: issue_id
          required: true
          schema:
            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:
                events:
                  - amount: '150.00'
                    currency: USD
                    event_type: payment.succeeded
                    flow: payment_to_wallet
                    id: evt_01J3Y0M8VJQ5W1R3E4J4K7N8P9
                    occurred_at: '2026-01-01T00:00:00Z'
                    received_at: '2026-01-01T00:00:01Z'
                    reference: order-123
                    status: processed
                limit: 50
              schema:
                $ref: '#/components/schemas/ListEventsResponse'
          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:
    ListEventsResponse:
      properties:
        events:
          description: Events returned in descending occurred-at order.
          items:
            $ref: '#/components/schemas/Event'
          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:
        - events
        - 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
    Event:
      properties:
        amount:
          description: Normalized decimal amount, when present.
          type:
            - string
            - 'null'
        currency:
          description: Three-letter ISO currency code, when present.
          type:
            - string
            - 'null'
        event_type:
          description: Lifecycle evidence type.
          enum:
            - payment.failed
            - payment.initiated
            - payment.succeeded
            - payout.failed
            - payout.initiated
            - payout.succeeded
            - wallet.credited
            - wallet.debited
            - wallet.refunded
          type: string
        flow:
          description: Monitored money-movement flow.
          enum:
            - payment_to_wallet
            - wallet_to_wallet
            - wallet_to_payout
          type: string
        id:
          description: Stable event identifier.
          type: string
        occurred_at:
          description: When the source event occurred.
          format: date-time
          type: string
        provider:
          description: Related provider name, when present.
          type:
            - string
            - 'null'
        received_at:
          description: When Reconify received the event.
          format: date-time
          type: string
        reference:
          description: Customer-supplied operation reference.
          type: string
        status:
          description: Asynchronous receipt processing state.
          enum:
            - received
            - published
            - processed
            - failed
          type: string
        wallet_id:
          description: Related wallet identifier, when present.
          type:
            - string
            - 'null'
      required:
        - id
        - flow
        - event_type
        - reference
        - occurred_at
        - received_at
        - status
      type: object
  securitySchemes:
    organizationApiKey:
      description: Organization API key. Use a write-scoped key for event ingestion.
      scheme: bearer
      type: http

````