Retrieve a list of credit memos

Retrieve a list of credit memos.

SecuritySecretApiKey or JWT or ApplicationJWT
Request
query Parameters
filter
string

The collection items filter requires a special format. Use "," for multiple allowed values. Use ";" for multiple fields. See the filter guide for more options and examples about this format.

sort
Array of strings

The collection items sort field and order (prefix with "-" for descending sort).

limit
integer [ 0 .. 1000 ]

The collection items limit.

offset
integer >= 0

The collection items offset.

q
string

The partial search of the text fields.

expand
string

Expand a response to get a full related object included inside of the _embedded path in the response. It accepts a comma-separated list of objects to expand. See the expand guide for more info.

Responses
200

A list of credit memos was retrieved successfully.

Response Headers
Pagination-Total
integer

Total items count.

Example: 332
Pagination-Limit
integer

Items per page limit.

Example: 100
Pagination-Offset
integer

Pagination offset.

Example: 2
Response Schema: application/json
Array
customerId
required
string (CustomerId) <= 50 characters

The customer resource ID. Defaults to UUID v4.

currency
required
string (CurrencyCode) = 3 characters

ISO 4217 alphabetic currency code.

id
string <= 50 characters

Credit memo ID.

invoiceId
string or null <= 50 characters

ID of the invoice which the credit memo is issued upon.

number
integer

An auto-incrementing number based on the sequence of credit memos for any particular customer.

Array of objects
Array
unitPrice
required
number <double>

Credit memo item's price.

quantity
required
integer

Credit memo item's quantity.

id
string <= 50 characters

Credit memo item ID.

invoiceItemId
string or null <= 50 characters

An invoice item's ID that the credit item is referenced to.

description
string

Credit memo item's description.

price
number <double>

Credit memo item's total price.

productId
string or null <= 50 characters

The related product's ID.

planId
string or null <= 50 characters

The related plan's ID.

status
string

Status of the credit memo.

Enum: Description
issued

The credit memo is available with a full amount to be applied.

applied

All the amount of the credit memo has been applied, no more credit can be created from it.

partially-applied

Some amount of the credit memo has been applied, credit of amount unusedAmount can be created from it.

voided

Some credit has or hasn't been created from the credit memo, but the credit memo cannot be used anymore.

reason
string

Credit memo reason code.

Enum: "return" "product-unsatisfactory" "order-change" "order-cancellation" "chargeback" "write-off" "waiver" "customer-credit" "other"
description
string

A public description (visible to customers) clarifying the purpose of the credit memo.

shippingAmount
number <double>
Default: 0

The (invoice's) shipping amount to credit.

taxAmount
number <double>
Default: 0

The (invoice's) tax amount to credit.

totalAmount
number <double>
Default: 0

The sum of all credits in the credit memo (items, shipping, tax).

unusedAmount
number <double>
Default: 0

The amount of totalAmount which hasn't been allocated anywhere yet.

revision
integer

Increments when the credit memo is modified.

createdTime
string <date-time>

Credit memo created time.

updatedTime
string <date-time> (UpdatedTime)

Read-only timestamp updates when the resource is updated.

Array of Self (object) or CustomerLink (object) or InvoiceLink (object)

The links related to resource.

Array
Any of:
href
required
string

The link URL.

rel
required
string

The link type.

Value: "self"
401

Unauthorized access, invalid credentials were used.

403

Access forbidden.

get/credit-memos
Request samples
Response samples
application/json
[
  • {
    }
]