InvoicesCredit notes

See what is left to credit on an invoice

GET
/v1/invoices/{id}/creditable

What is left uncredited on this invoice, line by line and in total. A void invoice answers with everything at zero.

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

currency*string

ISO 4217 currency code

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

What is left uncredited, before tax

Range0 <= value
tax*integer

The tax on what is left uncredited

Range0 <= value
total*integer

What is left uncredited, before tax and after it, added together

Range0 <= value
curl -X GET "https://example.com/v1/invoices/inv_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/creditable"
{  "currency": "USD",  "taxBps": 2000,  "lines": [    {      "saleId": "sal_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "description": "northwind-telecom.com, 2 years",      "quantity": 2,      "unitPrice": 1439,      "total": 2878,      "credited": 2878,      "creditable": 2878    }  ],  "subtotal": 2878,  "tax": 2878,  "total": 2878}