Get Debit Memo

GET /accounting/debit-memos/{id}

Group: Accounting › Debit Memos · Operation ID: getDebitMemo

Returns the debit memo with the given identifier, including its lines. Use the debit memo's id, not its debitMemoNumber.

Open in the interactive reference

Parameters

Name In Type Required Description
Api-Version header "v1" yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
id path string yes The unique identifier for the debit memo to return.

Response

200 Success

Under data (getDebitMemoOutput):

Field Type Required Description
id string yes The unique identifier for the debit memo.
debitMemoNumber string no The debit memo number, for example 'DM-1'. Absent while none has been assigned.
creditMemoId string no The source credit memo this debit memo settles. Absent on a standalone debit memo. See id on GET accounting/credit-memos/:id.
creditMemoNumber string no The number of the source credit memo. Present whenever creditMemoId is.
debitMemoDate string (date) yes The date the debit memo was issued. Format YYYY-MM-DD.
dueDate string (date) no The date the debit memo falls due. Format YYYY-MM-DD. Computed from debitMemoDate plus the payment term's days.
taxDate string (date) no The date the debit memo's tax was determined on. Format YYYY-MM-DD. Defaults to debitMemoDate.
approvalStatus string no The approval status of the debit memo. Possible values: 'draft', 'pendingApproval', 'revise', 'approved', 'rejected'. Only an approved debit memo has financial effect.
debitMemoStatus string no The payment and credit coverage status. Possible values: 'unpaid', 'isOverdue', 'partiallyPaid', 'paidInFull', 'creditedInFull', 'disputed'. Absent before approval.
debitMemoType string yes The reason key for the charge, for example 'orderEntryError'. The accepted keys are configured per tenant.
currency string yes The currency of the debit memo. Format ISO 4217, for example 'USD'. It governs every amount on the record.
customerId string yes The customer the debit memo is issued to. See id on GET accounting/customers/:id.
customerName string no The display name of the customer.
customerNumber string no The customer number.
entityId string yes The legal entity that issued the debit memo. See id on GET base/entities.
entityName string no The name of the issuing legal entity.
paymentTerm string yes The payment-term key applied to the debit memo. See code on GET accounting/payment-terms.
purchaseOrder string no The customer's own purchase-order reference.
customerMessage string no A free-text message shown to the customer on the document.
externalDebitMemoId string no The identifier of this debit memo in an external source system.
isMigrated boolean no Whether the debit memo was loaded from a previous system. When true, it is excluded from dunning and its journal entries are auto-reversed.
debitGlAccountId string no The header debit GL account the journal entry posts to, an Asset-type account. See id on GET accounting/accounts/:id.
billToAddressId string yes The bill-to address on the document. There is no endpoint for it.
soldToAddressId string yes The sold-to address on the document. There is no endpoint for it.
subtotal string (decimal) no The sum of the lines' pre-discount totals, in the debit memo currency.
totalAmount string (decimal) no The total including tax, in the debit memo currency.
totalTax string (decimal) no The total tax across all lines, in the debit memo currency.
totalAmountDebited string (decimal) no The gross amount debited, in the debit memo currency.
lineDiscounts string (decimal) no The sum of the prorated discount amounts across all lines, in the debit memo currency.
unappliedCreditAmount string (decimal) no The credit still unapplied on the source credit memo, in the debit memo currency. Absent on a standalone debit memo.
lastModifiedDate string (date-time) yes The date and time the debit memo record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.
lines array of object no The lines of the debit memo, each debiting one line of the source credit memo. An empty array when the debit memo has no lines. All line amounts are in the debit memo currency.
lines[].id string yes The unique identifier for the debit memo line.
lines[].lineNumber string no The sequential line number within the debit memo.
lines[].description string no A free-text line description, shown to the customer.
lines[].productId string no The debited product. Absent on a free-text line. See id on GET accounting/products/:id.
lines[].creditMemoLineId string no The source credit memo line this line debits. See lines[].id on GET accounting/credit-memos/:id.
lines[].quantity string (decimal) no The quantity debited. A count, not an amount, so it has no currency.
lines[].unitOfMeasure string no The unit-of-measure key, for example 'each'.
lines[].unitPrice string (decimal) no The price per unit, in the debit memo currency.
lines[].adjustedUnitPrice string (decimal) no The price per unit after adjustment, in the debit memo currency.
lines[].listPrice string (decimal) no The list price per unit as it stood on the source credit memo line, in the debit memo currency.
lines[].listPriceTotal string (decimal) no The pre-discount line total, in the debit memo currency.
lines[].discountAmount string (decimal) no The discount from the source credit memo line, in the debit memo currency.
lines[].discountPercentage string (decimal) no The discount as a percentage of the list price. A percentage, not an amount, so it has no currency.
lines[].totalPrice string (decimal) no The line total excluding tax, in the debit memo currency.
lines[].amountDebited string (decimal) no The amount debited for the line, in the debit memo currency.
lines[].totalAmountDue string (decimal) no The amount of the source credit memo line still available to debit, in the debit memo currency.
lines[].taxAmount string (decimal) no The tax on the line, in the debit memo currency.
lines[].taxCode string no The tax code applied to the line.
lines[].taxDate string (date) no The date the line's tax was determined on. Format YYYY-MM-DD.
lines[].taxMode string no How the line's prices are quoted for tax. Possible values: 'TaxInclusive', 'TaxExclusive'.
lines[].taxExemptCode string no The customer-level tax-exempt code applied to the line.
lines[].creditGlAccountId string no The line's credit GL account, the credit side of the journal entry. See id on GET accounting/accounts/:id.
lines[].serviceStartDate string (date) no The first day of the service period the line covers. Format YYYY-MM-DD.
lines[].serviceEndDate string (date) no The last day of the service period the line covers, inclusive. Format YYYY-MM-DD.

Errors

Code Status
NOT_FOUND 400

Statuses