Issue credit memo

POST /api/v1/credit-memos/{credit_memo_id}/issue

Issue a draft credit memo, making it available for application.

Operation ID: issue_credit_memo_api_v1_credit_memos__credit_memo_id__issue_post · 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

Path

credit_memo_id string required

Responses

201 Successful Response

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

400 Bad Request - Invalid input

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

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