InvoicesCredit notes

Get a credit note

GET
/v1/credit-notes/{id}

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Response Body

Success

application/json
  1. response

Success

id*string
number*string

Counts up from CN-0001 across your account, with no gaps

invoiceId*string
invoiceNumber*string
customerId*string
currency*string

The currency of every amount on the credit note

Value in"USD""EUR""GBP""CAD""AUD""NZD""CHF""SEK""NOK""DKK""PLN""INR""SGD""HKD""AED""ZAR""BRL""MXN"
lines*array<>
subtotal*integer

The lines added up, before tax

Range0 <= value
taxBps*|

Copied from the invoice's rate. Null when the invoice carried no tax

tax*integer

Minor units of the invoice's currency

Range0 <= value
total*integer

What this credit note comes to: subtotal plus tax

Range0 <= value
reason*string
issuedAt*string
Formatdate-time
shared*boolean

True once POST /credit-notes/{id}/share has made a public link for this credit note, false again once revoked. The token itself is never in this response or the list

issuer*|

The account as it billed the invoice this credit note corrects

curl -X GET "https://example.com/v1/credit-notes/crn_01K6XJ4Q8ZT3M9R5V2B7WDHNCA"
{  "id": "crn_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "number": "CN-0001",  "invoiceId": "inv_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "invoiceNumber": "INV-0001",  "customerId": "cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "currency": "USD",  "lines": [    {      "saleId": "sal_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "description": "northwind-telecom.com, 2 years",      "quantity": 2,      "unitPrice": 1439,      "total": 1439    }  ],  "subtotal": 2878,  "taxBps": 2000,  "tax": 576,  "total": 3454,  "reason": "Customer cancelled a seat",  "issuedAt": "2026-10-07T11:04:31.000Z",  "shared": true,  "issuer": {    "name": "Northwind Telecom",    "legalName": null,    "addressLines": [],    "taxId": null,    "billingEmail": null  }}