List credit memos

GET /api/v1/credit-memos

List all credit memos for the business with optional filtering.

Operation ID: list_credit_memos_api_v1_credit_memos_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

customer_id string

Filter by customer ID

status CreditMemoStatusEnum

Filter by status

has_remaining_balance boolean default: False

Only show memos with remaining balance

search string

Search by credit memo number (e.g. CM-0001)

cursor string

Pagination cursor

limit integer default: 50

Page size

Responses

200 Successful Response

items array · CreditMemoResponse requiredCreditMemoResponse

List of items

31 fields
id string required

Credit memo ID

business_id string required

Business that issued the credit

customer_id string required

Customer receiving the credit

invoice_id string

Original invoice being credited

number string

Auto-generated credit memo number (e.g. CM-001)

status string required

Status: draft, issued, partially_applied, fully_applied, void

currency string required

ISO currency code (e.g. USD)

amount integer required

Total credit amount in cents

amount_in_dollars string required

Total credit amount in dollars

amount_applied integer required

Amount applied in cents

amount_applied_in_dollars string required

Amount applied in dollars

amount_remaining integer required

Remaining amount in cents

amount_remaining_in_dollars string required

Remaining amount in dollars

issue_date string · date required

Date the credit memo was issued

applied_date string · date-time

When credits were last applied

created_at string · date-time required

Record creation timestamp

updated_at string · date-time required

Last update timestamp

reason string required

Reason code (e.g. pricing_error, refund, other)

reason_display string required

Human-readable reason label

description string

Description of the credit

internal_notes string

Internal notes (not visible to customer)

line_items object

Detailed line items breakdown

voided_at string · date-time

When the credit memo was voided

voided_reason string

Reason for voiding

customer_name string

Customer display name

invoice_number string

Original invoice number

applications array · CreditMemoApplicationResponse

Applications to invoices

can_be_applied boolean required

Whether credits can be applied to invoices

can_be_voided boolean required

Whether the credit memo can be voided

can_be_deleted boolean required

Whether the credit memo can be deleted (drafts only)

has_applications boolean required

Whether any credits have been applied

total integer

Total number of items (null when not calculated for performance)

limit integer

Pagination limit

next_cursor string

Cursor for next page

prev_cursor string

Cursor for previous page

has_next boolean required

Whether there are more items

has_prev boolean required

Whether there are previous items

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

422 Validation Error

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object