API documentation
Integrations
Analytics
Billable events
Companies
Custom properties
Customers
Customers > Credits
Customers > Payment methods
Integrations
Invoices
Invoicing entities
Organisations
Payments
Price configurations
Quotes
Subscriptions
- POSTRefresh subscriptions
- POSTCreate subscription update
- POSTCreate subscription updates
- POSTCancel subscription
- POSTReinstate subscription
- POSTPause subscription
- POSTActivate subscription
- POSTReactivate subscription
- GETGet subscriptions
- POSTCreate subscription
- GETGet subscription
- PUTUpdate subscription
- POSTRefresh seat products
- POSTTransition subscription to next phase
Third-party apps
Wallets
Create invoices
Create new invoices in batch (max 50 items).
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Customer ID.
Currency code of the invoice. See ISO 4217.
EUR, AED, AFN, XCD, ALL, AMD, AOA, ARS, USD, AUD, AWG, AZN, BAM, BBD, BDT, XOF, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, NOK, BWP, BYR, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUP, CVE, ANG, CZK, DJF, DKK, DOP, DZD, EGP, MAD, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, XPF, NGN, NIO, NPR, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, YER, ZAR, ZMW, ZWL ID of the invoicing entity attached to the invoice.
Indicates the current state of the invoice.
to_pay, paid, draft Unique identifier generated by Hyperline to ease reconciliation with payment. Useful for bank transfer.
Reference to the purchase order linked to the invoice.
Tax rate of the invoice.
0 < x < 100Payment method strategy used to charge the invoice. Only applies to to_pay status.
current: Use the current default payment method of the customer.external: Manage the payment of the invoice outside of Hyperline.
current, external Emission date of the invoice.
Due date of the invoice. Computed from the emission date and the payment delay configured in your settings.
Date the invoice was fully paid.
Product ID related to the invoice line item. Only products of type flat_fee can be used.
Name of the line item as it will appear on the invoice. Default to the product name.
Description of the line item as it will appear on the invoice. Default to the product description.
Count of units of the product related to the invoice line item.
Amount of one unit of the product related to the invoice line item. Default to the product price amount. Expressed in the currency's smallest unit.
Start date of the period corresponding to the line item charge.
End date of the period corresponding to the line item charge.
Custom note added to the invoice.
A unique identifier for the invoices in the batch
Response
Invoice ID.
Invoice number is generated by Hyperline and follows the format defined in your settings.
The type of the invoice:
- invoice: the base type for a legal invoice to charge your customer
- credit_note: the base type for a legal credit note to refund your customer or cancel an invoice
- document: a type that has no legal value you can generate from a subscription to create a summary for instance
invoice, credit_note, document, child_invoice_ref, child_creditnote_ref If the invoice is of type document you can give it a custom name (will be displayed before the number)
Indicates the current state of the invoice.
draft, open, to_pay, grace_period, partially_paid, paid, late, voided, closed, error, missing_info, archived, charged_on_parent, pending_parent_concat Unique identifier generated by Hyperline to ease reconciliation with payment. Useful for bank transfer.
Reference to the purchase order linked to the invoice.
ID of the original invoice this credit note is linked to (only used for credit note).
Number of the original invoice this credit note is linked to (only used for credit note).
Currency code. See ISO 4217.
EUR, AED, AFN, XCD, ALL, AMD, AOA, ARS, USD, AUD, AWG, AZN, BAM, BBD, BDT, XOF, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, NOK, BWP, BYR, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUP, CVE, ANG, CZK, DJF, DKK, DOP, DZD, EGP, MAD, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, XPF, NGN, NIO, NPR, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, YER, ZAR, ZMW, ZWL Sum of the amount and taxes amount of all products on the invoice. Expressed in the currency's smallest unit.
Amount still need to be paid for the invoice. Expressed in the currency's smallest unit.
Amount already paid for the invoice. Expressed in the currency's smallest unit.
Amount corresponding to the recurring non-variable part of the total amount. Expressed in the currency's smallest unit.
Total amount without the taxes amount. Expressed in the currency's smallest unit.
Tax amount of the invoice. Expressed in the currency's smallest unit.
Tax amount of the invoice. Expressed in the currency's smallest unit.
standard: Default behavior, tax is automatically computed and applied.exempt: No tax rate applied because the customer country doesn't require it.reverse_charge: No tax rate applied because the customer is eligible to EU reverse charge.manual: Tax rate has been manually specified when creating the invoice.not_eligible: You've disabled tax collection in this country.
exempt, standard, reverse_charge, manual, not_eligible Amount corresponding to the discounted part of the total amount. Expressed in the currency's smallest unit.
Conversion rate used between the invoice currency and your accounting currency.
Amount converted using the conversion rate. Expressed in the currency's smallest unit.
Date of the conversion of the amount.
ID of the payment method used to pay the invoice.
Number of attempts to pay the invoice.
Custom note added to the invoice.
Customer ID.
Customer name.
Email to which all communications will be sent.
ID of the customer in your system. This helps matching your customer with the one on Hyperline.
Customer tax number.
Customer billing address.
Address name.
Address first line.
Address second line (optional).
Address city.
Address ZIP code.
Address state (only for US country).
Two-letter country code in ISO format. See ISO 3166 Alpha 2.
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW ID of the invoicing entity attached to the invoice.
Name of the invoicing entity
Tax identifier / VAT number of the invoicing entity
Seller address.
Address name.
Address first line.
Address second line (optional).
Address city.
Address ZIP code.
Address state (only for US country).
Two-letter country code in ISO format. See ISO 3166 Alpha 2.
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW ID of the subscription related to the invoice.
Start date of the billing period of the invoice.
End date of the billing period of the invoice.
Emission date of the invoice.
Due date of the invoice. Computed from the emission date and the payment delay configured in your settings.
Date corresponding to the refund of the invoice, previously paid. A credit note exists with an original invoice ID equals to this invoice ID.
Date the invoice grace period ended. This happens at the emission date + the grace period duration configured in your settings.
Date the invoice was fully paid.
Date of the last update
Invoice line item ID.
Name of the line item, corresponding to the related product.
Product ID related to the invoice line item.
Product type related to the invoice line item.
flat_fee, seat, dynamic, credit Count of units of the product related to the invoice line item.
Amount of one unit of the product related to the invoice line item. Expressed in the currency's smallest unit.
Total amount of the invoice line item. Expressed in the currency's smallest unit.
Total amount without the taxes amount of the invoice line item. Expressed in the currency's smallest unit.
Tax rate of the invoice line item.
Custom tax rate ID applied to the invoice line item.
Tax amount of the invoice line item. Expressed in the currency's smallest unit.
Amount corresponding to the discounted part of the total amount of the invoice line item. Expressed in the currency's smallest unit.
Percentage applied to compute the discounted part of the invoice line amount. Only if coupons applied are percentage based.
Start date of the period corresponding to the line item charge.
End date of the period corresponding to the line item charge.
Transaction ID.
subscription: The transaction is related to a subscription payment.one_time: The transaction is related to a one-time payment.refund: The transaction is related to a refund payment.
subscription, one_time, refund Transaction amount.
Transaction currency.
EUR, AED, AFN, XCD, ALL, AMD, AOA, ARS, USD, AUD, AWG, AZN, BAM, BBD, BDT, XOF, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, NOK, BWP, BYR, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUP, CVE, ANG, CZK, DJF, DKK, DOP, DZD, EGP, MAD, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, XPF, NGN, NIO, NPR, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, YER, ZAR, ZMW, ZWL ID of the customer linked to the transaction.
ID of the transaction on the payment provider (Stripe, Mollie, GoCardless, ...) side.
Date corresponding to the processing of the transaction.
Date corresponding to the refund of the transaction.
Date corresponding to the last synchronization of the details with the payment provider.
card, transfer, transfer_automated, direct_debit, direct_debit_ach, direct_debit_bacs, external Default payment method of the customer. Only applies to card and direct debit.
Payment method ID.
Type of payment method.
card: Credit or debit carddirect_debit_sepa: SEPA Direct Debitdirect_debit_ach: ACH Direct Debit with an US bank accountdirect_debit_bacs: Bacs Direct Debit with an UK bank accounttransfer: Bank transfer on an external bank account (manual reconciliation)transfer_automated: Bank transfer with automated reconciliationexternal: Payment method managed outside of Hyperline
card Last four digits of the card.
Expiration date of the card using YYYY-MM format.
Brand of the card.
to_process: The transaction is waiting to be processed by our system.pending: The transaction has been authorized by the related payment processor, but the banking transaction is not yet settled.settled: The transaction has been cleared on the banking side, the money transfer is fully completed.cancelled: The transaction has been cancelled and won't be processed again.
to_process, pending, settled, cancelled, scheduled Coupon ID.
Coupon name.
Amount to apply as a discount on the total amount (excluding taxes) of a subscription. Expressed in the currency's smallest unit.
Percentage to apply as a discount on the amount (excluding taxes) of a product.
IDs of the line items to which the coupon applies.
A unique identifier for the invoices in the batch
Was this page helpful?