---
title: "List credit notes for CRM"
method: GET
path: "/api/refunds/issued"
tags: ["refunds"]
---

# List credit notes for CRM

`GET /api/refunds/issued`

Admin/Finance endpoint. Returns all credit notes linked to refund requests, with pagination.

## Query parameters

- `page` integer
- `per_page` integer
- `progressive_refund_number` integer, nullable — Exact progressive refund number filter
- `refund_status` string, nullable — Refund workflow status filter (e.g. pending, validation_failed, stripe_failed, stripe_succeeded, sts_failed, sts_succeeded, skipped).
- `credit_note_status` string, nullable — Credit note status filter (e.g. created, sent, failed).
- `patient_name` string, nullable — Patient name filter (first, last or full name)

## Response `200`

Successful Response

- ListRefundsResponse — Response for issued refunds list endpoint.
  - `success` boolean, required
  - `data` RefundListItemResponse[]
    - `refund_request_id` string, required
    - `progressive_refund_number` integer, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `event_status` 'pending' | 'validation_failed' | 'stripe_failed' | 'stripe_succeeded' | 'sts_failed' | 'sts_succeeded' | 'skipped' | 'failed' | 'succeeded', required — Event status stored in patient_refunds (includes legacy generic statuses).
    - `event_type` string, nullable
    - `payment_id` string, nullable
    - `appointment_id` string, nullable
    - `invoice_id` string, nullable
    - `credit_note_id` string, nullable
    - `stripe_refund_id` string, nullable
    - `sts_reference_id` string, nullable
    - `refund_amount` string, nullable
    - `currency` string, nullable
    - `reason` string, nullable
    - `payment_amount` string, nullable
    - `payment_status` 'pending' | 'processing' | 'succeeded' | 'failed' | 'cancelled' | 'refunded' | 'partially_refunded' | 'expired' | 'unpaid' — Payment status constants. Mostly Stripe PaymentIntent statuses; also includes values used on appointments and Stripe Checkout Session ``payment_status`` (e.g. ``unpaid`` when checkout is still awaiting payment).
    - `payment_invoice_status` string, nullable
    - `patient_first_name` string, nullable
    - `patient_last_name` string, nullable
    - `patient_email` string, nullable
    - `credit_note_status` 'created' | 'sent' | 'failed' — Credit note status values used by refund flow.
    - `credit_note_document_number` string, nullable
    - `credit_note_external_reference` string, nullable
    - `credit_note_pdf_url` string, nullable
    - `credit_note_sts_message` string, nullable
    - `credit_note_sts_protocol` string, nullable
    - `credit_note_sent_at` string, date-time, nullable
    - `credit_note_failed_at` string, date-time, nullable
    - `sts_send_outcomes` RefundStsSendOutcome[]
      - `status` 'succeeded' | 'failed' | 'not_sent' | 'pending', required — Frontend-ready STS send outcome status.
      - `source` string, required
      - `message` string, nullable
      - `protocol` string, nullable
      - `sent_at` string, date-time, nullable
      - `failed_at` string, date-time, nullable
  - `pagination` ListRefundsPaginationResponse, required — Pagination block for refunds list response.
    - `page` integer, required
    - `per_page` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)