List an invoice's related credit or charge invoices
GET/invoices/{invoice_id}/related_invoices
Use it in a workflow
Add a step and choose the Recurly connector.
Pick the List Related Invoices action (under invoice).
Fill in the fields below, then reference the result from later steps as {{listRelatedInvoices.response.data}}.
Request
Path parameters
invoice_idstringrequired
Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
Response
Returns 200 with an object. Read it in later steps with {{listRelatedInvoices.response.data.<field>}}.
objectstring
Will always be List.
has_moreboolean
Indicates there are more results on subsequent pages.
nextstring
Path to subsequent page of results.
dataarray<object>
idstring
uuidstring
objectstring
typestring
Invoices are either charge, credit, or legacy invoices.
One ofchargecreditlegacy
originstring
The event that created the invoice.
One ofcarryforward_creditcarryforward_gift_creditcreditexternal_refundgift_cardimmediate_changeimportline_item_refundopen_amount_refundprepaymentpurchaserefundrenewalterminationusage_correctionwrite_off
statestring
One ofopenpendingprocessingpast_duepaidclosedfailedvoidedDefault "all"
accountobject10 fields
billing_info_idstring
The `billing_info_id` is the value that represents a specific billing info for an end customer. When `billing_info_id` is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info. `billing_info_id` can ONLY be used for sites utilizing the Wallet feature.
subscription_idsarray<string>
If the invoice is charging or refunding for one or more subscriptions, these are their IDs.
previous_invoice_idstring
On refund invoices, this value will exist and show the invoice ID of the purchase invoice the refund was created from. This field is only populated for sites without the [Only Bill What Changed](https://docs.recurly.com/docs/only-bill-what-changed) feature enabled. Sites with Only Bill What Changed enabled should use the [related_invoices endpoint](https://recurly.com/developers/api/v2021-02-25/index.html#operation/list_related_invoices) to see purchase invoices refunded by this invoice.
numberstring
If VAT taxation and the Country Invoice Sequencing feature are enabled, invoices will have country-specific invoice numbers for invoices billed to EU countries (ex: FR1001). Non-EU invoices will continue to use the site-level invoice number sequence.
collection_methodstring
An automatic invoice means a corresponding transaction is run using the account's billing information at the same time the invoice is created. Manual invoices are created without a corresponding transaction. The merchant must enter a manual payment transaction or have the customer pay the invoice with an automatic method, like credit card, PayPal, Amazon, or ACH bank payment.
One ofautomaticmanualDefault "automatic"
po_numberstring
For manual invoicing, this identifies the PO number associated with the subscription.
net_termsinteger
Integer paired with `Net Terms Type` and representing the number
of days past the current date (for `net` Net Terms Type) or days after
the last day of the current month (for `eom` Net Terms Type) that the
invoice will become past due. For `manual` collection method, an additional 24 hours is
added to ensure the customer has the entire last day to make payment before
becoming past due. For example:
If an invoice is due `net 0`, it is due 'On Receipt' and will become past due 24 hours after it's created.
If an invoice is due `net 30`, it will become past due at 31 days exactly.
If an invoice is due `eom 30`, it will become past due 31 days from the last day of the current month.
For `automatic` collection method, the additional 24 hours is not added. For example, On-Receipt is due immediately, and `net 30` will become due exactly 30 days from invoice generation, at which point Recurly will attempt collection.
When `eom` Net Terms Type is passed, the value for `Net Terms` is restricted to `0, 15, 30, 45, 60, or 90`.
For more information on how net terms work with `manual` collection visit our docs page (https://docs.recurly.com/docs/manual-payments#section-collection-terms)
or visit (https://docs.recurly.com/docs/automatic-invoicing-terms#section-collection-terms) for information about net terms using `automatic` collection.
Default 0
net_terms_typestring
Optionally supplied string that may be either `net` or `eom` (end-of-month).
When `net`, an invoice becomes past due the specified number of `Net Terms` days from the current date.
When `eom` an invoice becomes past due the specified number of `Net Terms` days from the last day of the current month.
One ofneteomDefault "net"
addressobject2 fields
shipping_addressobject19 fields
currencystring
3-letter ISO 4217 currency code.
discountnumber (float)
Total discounts applied to this invoice.
coupon_redemptionsarray<object>7 fields
The coupon redemptions applied to this invoice.
subtotalnumber (float)
The summation of charges and credits, before discounts and taxes.
subtotal_after_discountnumber (float)
The summation of charges and credits, after discounts applied.
taxnumber (float)
The total tax on this invoice.
reference_only_currency_conversionobject6 fields
totalnumber (float)
The final total on this invoice. The summation of invoice charges, discounts, credits, and tax.
refundable_amountnumber (float)
The refundable amount on a charge invoice. It will be null for all other invoices.
paidnumber (float)
The total amount of successful payments transaction on this invoice.
balancenumber (float)
The outstanding balance remaining on this invoice.
tax_infoobject4 fields
Only for merchants using Recurly's In-The-Box taxes.
used_tax_serviceboolean
Will be `true` when the invoice had a successful response from the tax service and `false` when the invoice was not sent to tax service due to a lack of address or enabled jurisdiction or was processed without tax due to a non-blocking error returned from the tax service.
vat_numberstring
VAT registration number for the customer on this invoice. This will come from the VAT Number field in the Billing Info or the Account Info depending on your tax settings and the invoice collection method.
vat_reverse_charge_notesstring
VAT Reverse Charge Notes only appear if you have EU VAT enabled or are using your own Avalara AvaTax account and the customer is in the EU, has a VAT number, and is in a different country than your own. This will default to the VAT Reverse Charge Notes text specified on the Tax Settings page in your Recurly admin, unless custom notes were created with the original subscription.
terms_and_conditionsstring
This will default to the Terms and Conditions text specified on the Invoice Settings page in your Recurly admin. Specify custom notes to add or override Terms and Conditions.
customer_notesstring
This will default to the Customer Notes text specified on the Invoice Settings. Specify custom notes to add or override Customer Notes.
line_itemsarray<object>40 fields
has_more_line_itemsboolean
Identifies if the invoice has more line items than are returned in `line_items`. If `has_more_line_items` is `true`, then a request needs to be made to the `list_invoice_line_items` endpoint.