Invoices
The Invoice object represents an itemized record of goods and/or services sold to a customer.The Invoice object
Properties
idStringRequired
typeEnumOptional
Whether the invoice is an accounts receivable or accounts payable. If
type is accounts_payable, the invoice is a bill. If type is accounts_receivable, it is an invoice. Possible values include: ACCOUNTS_RECEIVABLE, ACCOUNTS_PAYABLE, or - in cases where there is no clear mapping - the original value passed through.contactStringOptional
The invoice's contact.
numberStringOptional
The invoice's number.
issue_dateStringOptional
The invoice's issue date.
due_dateStringOptional
The invoice's due date.
paid_on_dateStringOptional
The invoice's paid date.
memoStringOptional
The invoice's private note.
companyStringOptional
The company the invoice belongs to.
currencyEnumOptional
The invoice's currency. Possible values include:
XUA, AFN, AFA, ALL, ALK, DZD, ADP, AOA, AOK, AON, AOR, ARA, ARS, ARM, ARP, ARL, AMD, AWG, AUD, ATS, AZN, AZM, BSD, BHD, BDT, BBD, BYN, BYB, BYR, BEF, BEC, BEL, BZD, BMD, BTN, BOB, BOL, BOV, BOP, BAM, BAD, BAN, BWP, BRC, BRZ, BRE, BRR, BRN, BRB, BRL, GBP, BND, BGL, BGN, BGO, BGM, BUK, BIF, XPF, KHR, CAD, CVE, KYD, XAF, CLE, CLP, CLF, CNX, CNY, CNH, COP, COU, KMF, CDF, CRC, HRD, HRK, CUC, CUP, CYP, CZK, CSK, DKK, DJF, DOP, NLG, XCD, DDM, ECS, ECV, EGP, GQE, ERN, EEK, ETB, EUR, XBA, XEU, XBB, XBC, XBD, FKP, FJD, FIM, FRF, XFO, XFU, GMD, GEK, GEL, DEM, GHS, GHC, GIP, XAU, GRD, GTQ, GWP, GNF, GNS, GYD, HTG, HNL, HKD, HUF, IMP, ISK, ISJ, INR, IDR, IRR, IQD, IEP, ILS, ILP, ILR, ITL, JMD, JPY, JOD, KZT, KES, KWD, KGS, LAK, LVL, LVR, LBP, LSL, LRD, LYD, LTL, LTT, LUL, LUC, LUF, MOP, MKD, MKN, MGA, MGF, MWK, MYR, MVR, MVP, MLF, MTL, MTP, MRU, MRO, MUR, MXV, MXN, MXP, MDC, MDL, MCF, MNT, MAD, MAF, MZE, MZN, MZM, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NIC, NGN, KPW, NOK, OMR, PKR, XPD, PAB, PGK, PYG, PEI, PEN, PES, PHP, XPT, PLN, PLZ, PTE, GWE, QAR, XRE, RHD, RON, ROL, RUB, RUR, RWF, SVC, WST, SAR, RSD, CSD, SCR, SLL, XAG, SGD, SKK, SIT, SBD, SOS, ZAR, ZAL, KRH, KRW, KRO, SSP, SUR, ESP, ESA, ESB, XDR, LKR, SHP, XSU, SDD, SDG, SDP, SRD, SRG, SZL, SEK, CHF, SYP, STN, STD, TVD, TJR, TJS, TZS, XTS, THB, XXX, TPE, TOP, TTD, TND, TRY, TRL, TMT, TMM, USD, USN, USS, UGX, UGS, UAH, UAK, AED, UYW, UYU, UYP, UYI, UZS, VUV, VES, VEB, VEF, VND, VNN, CHE, CHW, XOF, YDD, YER, YUN, YUD, YUM, YUR, ZWN, ZRN, ZRZ, ZMW, ZMK, ZWD, ZWR, ZWL, or - in cases where there is no clear mapping - the original value passed through.exchange_rateStringOptional
The invoice's exchange rate.
total_discountNumberOptional
The total discounts applied to the total cost.
sub_totalNumberOptional
The total amount being paid before taxes.
total_tax_amountNumberOptional
The total amount being paid in taxes.
total_amountNumberOptional
The invoice's total amount.
balanceNumberOptional
The invoice's remaining balance.
remote_updated_atStringOptional
When the third party's invoice entry was updated.
tracking_categoriesArrayRequired
paymentsArrayRequired
Array of
Payment object IDs.line_itemsInvoiceLineItem[]Required
The InvoiceLineItem object
The
InvoiceLineItem object represents an itemized record of goods and/or services sold to a customer.JSON
{"remote_id": "8765432","description": "Pickleball lessons","unit_price": 50,"quantity": 1,"total_amount": 50,"currency": "USD","exchange_rate": "2.9","item": "5b3c1341-a20f-4e51-b72c-f3830a16c97b","account": "cd0f32d4-a493-11ec-b909-0242ac120002","tracking_category": "b38c59b0-a9d7-4740-b1ee-5436c6751e3d","tracking_categories": ["b38c59b0-a9d7-4740-b1ee-5436c6751e3d","9b840d2-686a-465a-8a8e-7b028498f8e4","a47e11b6-c73b-4a0c-be31-130fc48177fa"],"company": "595c8f97-2ac4-45b7-b000-41bdf43240b5","id": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8",Show advanced fields}
Properties
remote_idStringOptional
The third-party API ID of the matching object.
descriptionStringOptional
The line item's description.
unit_priceNumberOptional
The line item's unit price.
quantityNumberOptional
The line item's quantity.
total_amountNumberOptional
The line item's total amount.
currencyEnumOptional
The line item's currency. Possible values include:
XUA, AFN, AFA, ALL, ALK, DZD, ADP, AOA, AOK, AON, AOR, ARA, ARS, ARM, ARP, ARL, AMD, AWG, AUD, ATS, AZN, AZM, BSD, BHD, BDT, BBD, BYN, BYB, BYR, BEF, BEC, BEL, BZD, BMD, BTN, BOB, BOL, BOV, BOP, BAM, BAD, BAN, BWP, BRC, BRZ, BRE, BRR, BRN, BRB, BRL, GBP, BND, BGL, BGN, BGO, BGM, BUK, BIF, XPF, KHR, CAD, CVE, KYD, XAF, CLE, CLP, CLF, CNX, CNY, CNH, COP, COU, KMF, CDF, CRC, HRD, HRK, CUC, CUP, CYP, CZK, CSK, DKK, DJF, DOP, NLG, XCD, DDM, ECS, ECV, EGP, GQE, ERN, EEK, ETB, EUR, XBA, XEU, XBB, XBC, XBD, FKP, FJD, FIM, FRF, XFO, XFU, GMD, GEK, GEL, DEM, GHS, GHC, GIP, XAU, GRD, GTQ, GWP, GNF, GNS, GYD, HTG, HNL, HKD, HUF, IMP, ISK, ISJ, INR, IDR, IRR, IQD, IEP, ILS, ILP, ILR, ITL, JMD, JPY, JOD, KZT, KES, KWD, KGS, LAK, LVL, LVR, LBP, LSL, LRD, LYD, LTL, LTT, LUL, LUC, LUF, MOP, MKD, MKN, MGA, MGF, MWK, MYR, MVR, MVP, MLF, MTL, MTP, MRU, MRO, MUR, MXV, MXN, MXP, MDC, MDL, MCF, MNT, MAD, MAF, MZE, MZN, MZM, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NIC, NGN, KPW, NOK, OMR, PKR, XPD, PAB, PGK, PYG, PEI, PEN, PES, PHP, XPT, PLN, PLZ, PTE, GWE, QAR, XRE, RHD, RON, ROL, RUB, RUR, RWF, SVC, WST, SAR, RSD, CSD, SCR, SLL, XAG, SGD, SKK, SIT, SBD, SOS, ZAR, ZAL, KRH, KRW, KRO, SSP, SUR, ESP, ESA, ESB, XDR, LKR, SHP, XSU, SDD, SDG, SDP, SRD, SRG, SZL, SEK, CHF, SYP, STN, STD, TVD, TJR, TJS, TZS, XTS, THB, XXX, TPE, TOP, TTD, TND, TRY, TRL, TMT, TMM, USD, USN, USS, UGX, UGS, UAH, UAK, AED, UYW, UYU, UYP, UYI, UZS, VUV, VES, VEB, VEF, VND, VNN, CHE, CHW, XOF, YDD, YER, YUN, YUD, YUM, YUR, ZWN, ZRN, ZRZ, ZMW, ZMK, ZWD, ZWR, ZWL, or - in cases where there is no clear mapping - the original value passed through.exchange_rateStringOptional
The line item's exchange rate.
itemStringOptional
accountStringOptional
tracking_categoryStringOptional
tracking_categoriesArrayRequired
companyStringOptional
The company the line item belongs to.
idStringRequired
field_mappingsObjectOptional
modified_atStringRequired
This is the datetime that this object was last updated by Merge
remote_was_deletedBooleanRequired
remote_idStringOptional
The third-party API ID of the matching object.
field_mappingsObjectOptional
modified_atStringRequired
This is the datetime that this object was last updated by Merge
remote_dataRemoteData[]Optional
The Invoice object
JSON
{"id": "9871b4a9-f5d2-4f3b-a66b-dfedbed42c46","type": "ACCOUNTS_RECEIVABLE","contact": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","number": "AIQ12546","issue_date": "2020-03-31T00:00:00Z","due_date": "2020-04-15T00:00:00Z","paid_on_date": "2020-04-01T00:00:00Z","memo": "Weekly Payment","company": "595c8f97-2ac4-45b7-b000-41bdf43240b5","currency": "USD","exchange_rate": "2.9","total_discount": 0,"sub_total": 100,"total_tax_amount": 5,"total_amount": 105,"balance": 105,"remote_updated_at": "2020-04-01T00:00:00Z","tracking_categories": ["7dc5ca17-d311-44cd-9ce0-333080367a18","6aa0700c-48e1-4c4a-8162-02e6a582df05","8c933d61-8f5b-4360-ac0c-c9dc87bee763"],"payments": ["b26fd49a-cbae-470a-a8f8-bcbc119e0390"],"line_items": [{"id": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","remote_id": "8765432","description": "Pickleball lessons","unit_price": 50,"quantity": 1,"total_amount": 50,"currency": "USD","exchange_rate": "2.9","item": "5b3c1341-a20f-4e51-b72c-f3830a16c97b","account": "cd0f32d4-a493-11ec-b909-0242ac120002","tracking_category": "b38c59b0-a9d7-4740-b1ee-5436c6751e3d","tracking_categories": ["b38c59b0-a9d7-4740-b1ee-5436c6751e3d","9b840d2-686a-465a-8a8e-7b028498f8e4","a47e11b6-c73b-4a0c-be31-130fc48177fa"],"company": "595c8f97-2ac4-45b7-b000-41bdf43240b5",Show advanced fields}]}
GET
/invoices
Returns a list of Invoice objects.
Header Parameters
AuthorizationStringRequired
Token-based authentication with required prefix "Bearer"
X-Account-TokenStringRequired
Token identifying the end user.
Query & Path Parameters
company_idStringOptional
If provided, will only return invoices for this company.
contact_idStringOptional
If provided, will only return invoices for this contact.
created_afterStringOptional
If provided, will only return objects created after this datetime.
created_beforeStringOptional
If provided, will only return objects created before this datetime.
cursorStringOptional
The pagination cursor value.
expandStringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
include_deleted_dataBooleanOptional
Whether to include data that was marked as deleted by third party webhooks.
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
issue_date_afterStringOptional
If provided, will only return objects created after this datetime.
issue_date_beforeStringOptional
If provided, will only return objects created before this datetime.
modified_afterStringOptional
If provided, only objects synced by Merge after this date time will be returned.
modified_beforeStringOptional
If provided, only objects synced by Merge before this date time will be returned.
page_sizeIntegerOptional
Number of results to return per page.
remote_fieldsStringOptional
Deprecated. Use show_enum_origins.
remote_idStringOptional
The API provider's ID for the given object.
show_enum_originsStringOptional
Which fields should be returned in non-normalized form.
typeStringOptional
If provided, will only return Invoices with this type
Response
JSON
{"next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw","previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ","results": [{"id": "9871b4a9-f5d2-4f3b-a66b-dfedbed42c46","type": "ACCOUNTS_RECEIVABLE","contact": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","number": "AIQ12546","issue_date": "2020-03-31T00:00:00Z","due_date": "2020-04-15T00:00:00Z","paid_on_date": "2020-04-01T00:00:00Z","memo": "Weekly Payment","company": "595c8f97-2ac4-45b7-b000-41bdf43240b5","currency": "USD","exchange_rate": "2.9","total_discount": 0,"sub_total": 100,"total_tax_amount": 5,"total_amount": 105,"balance": 105,"remote_updated_at": "2020-04-01T00:00:00Z","tracking_categories": ["7dc5ca17-d311-44cd-9ce0-333080367a18","6aa0700c-48e1-4c4a-8162-02e6a582df05","8c933d61-8f5b-4360-ac0c-c9dc87bee763"],"payments": ["b26fd49a-cbae-470a-a8f8-bcbc119e0390"],"line_items": [{"id": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","remote_id": "8765432","description": "Pickleball lessons","unit_price": 50,"quantity": 1,"total_amount": 50,"currency": "USD","exchange_rate": "2.9","item": "5b3c1341-a20f-4e51-b72c-f3830a16c97b","account": "cd0f32d4-a493-11ec-b909-0242ac120002","tracking_category": "b38c59b0-a9d7-4740-b1ee-5436c6751e3d","tracking_categories": ["b38c59b0-a9d7-4740-b1ee-5436c6751e3d","9b840d2-686a-465a-8a8e-7b028498f8e4","a47e11b6-c73b-4a0c-be31-130fc48177fa"],"company": "595c8f97-2ac4-45b7-b000-41bdf43240b5",Show advanced fields}]}]}
Field support by platform
Clear Books
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]descriptionstringunit_pricenumberquantitynumberbalanceNumbercurrencyEnumdue_dateStringissue_dateStringnumberStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertotal_tax_amountNumbertypeEnum
FreeAgent
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberaccountstringbalanceNumbercontactStringcurrencyEnumdue_dateStringissue_dateStringmemoStringnumberStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertypeEnum
FreshBooks
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberbalanceNumbercontactStringcurrencyEnumdue_dateStringissue_dateStringnumberStringpaid_on_dateStringpaymentsArrayremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertypeEnum
Microsoft Dynamics 365 Business Central
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringtracking_categoriesarraycontactStringcurrencyEnumdue_dateStringissue_dateStringnumberStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertracking_categoriesArraytypeEnum
Moneybird
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringbalanceNumbercontactStringcurrencyEnumdue_dateStringissue_dateStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertotal_discountNumbertypeEnum
NetSuite
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberexchange_ratestringitemstringaccountstringtracking_categorystringtracking_categoriesarraybalanceNumbercompanyStringcontactStringcurrencyEnumdue_dateStringexchange_rateStringissue_dateStringmemoStringnumberStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertracking_categoriesArraytypeEnum
QuickBooks Online
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringtracking_categorystringtracking_categoriesarraybalanceNumbercontactStringcurrencyEnumdue_dateStringexchange_rateStringissue_dateStringmemoStringnumberStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertotal_tax_amountNumbertracking_categoriesArraytypeEnum
Sage Business Cloud Accounting
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringbalanceNumbercontactStringcurrencyEnumdue_dateStringexchange_rateStringissue_dateStringnumberStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertypeEnum
Sage Intacct
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringtotal_amountnumberitemstringaccountstringtracking_categorystringtracking_categoriesarraybalanceNumbercontactStringcurrencyEnumdue_dateStringissue_dateStringmemoStringnumberStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringtotal_amountNumbertypeEnum
Wave Financial
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]descriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringbalanceNumbercontactStringcurrencyEnumdue_dateStringissue_dateStringmemoStringnumberStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertypeEnum
Workday
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringunit_pricenumberquantitynumbertotal_amountnumberitemstringcompanystringbalanceNumbercompanyStringcontactStringcurrencyEnumdue_dateStringexchange_rateStringissue_dateStringmemoStringnumberStringremote_dataRemoteData[]pathstringdataobjectremote_idStringtotal_amountNumbertotal_tax_amountNumbertypeEnum
Xero
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringtracking_categoriesarraybalanceNumbercontactStringcurrencyEnumdue_dateStringexchange_rateStringissue_dateStringmemoStringnumberStringpaid_on_dateStringremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertypeEnum
Zoho Books
Merge supports Passthrough Requests to this platform's API
Supported Response Fields
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumberitemstringaccountstringcompanystringbalanceNumbercompanyStringcontactStringcurrencyEnumdue_dateStringissue_dateStringmemoStringnumberStringpaid_on_dateStringpaymentsArrayremote_dataRemoteData[]pathstringdataobjectremote_idStringremote_updated_atStringsub_totalNumbertotal_amountNumbertotal_discountNumbertotal_tax_amountNumbertypeEnumHint: Use the /linked-accounts endpoint to pull platform support information.
POST
/invoices
Creates an Invoice object with the given values.
Header Parameters
AuthorizationStringRequired
Token-based authentication with required prefix "Bearer"
X-Account-TokenStringRequired
Token identifying the end user.
Query & Path Parameters
is_debug_modeBooleanOptional
Whether to include debug fields (such as log file links) in the response.
run_asyncBooleanOptional
Whether or not third-party updates should be run asynchronously.
Body Parameters
modelObjectRequired
Find available fields below under “Model Parameters”.
Model Parameters
View app-specific writable fields under “Field support by platform” in this section.typeEnumWhether the invoice is an accounts receivable or accounts payable. If
type is accounts_payable, the invoice is a bill. If type is accounts_receivable, it is an invoice. Must pass in one of the following choices: ACCOUNTS_RECEIVABLE, ACCOUNTS_PAYABLE.contactStringThe invoice's contact. Must pass in a valid Merge ID, which can be obtained from the
id field in the Contact object.numberStringThe invoice's number.
issue_dateStringThe invoice's issue date.
due_dateStringThe invoice's due date.
paid_on_dateStringThe invoice's paid date.
memoStringThe invoice's private note.
companyStringThe company the invoice belongs to. Must pass in a valid Merge ID, which can be obtained from the
id field in the CompanyInfo object.currencyEnumThe invoice's currency. Must pass in one of the following choices:
XUA, AFN, AFA, ALL, ALK, DZD, ADP, AOA, AOK, AON, AOR, ARA, ARS, ARM, ARP, ARL, AMD, AWG, AUD, ATS, AZN, AZM, BSD, BHD, BDT, BBD, BYN, BYB, BYR, BEF, BEC, BEL, BZD, BMD, BTN, BOB, BOL, BOV, BOP, BAM, BAD, BAN, BWP, BRC, BRZ, BRE, BRR, BRN, BRB, BRL, GBP, BND, BGL, BGN, BGO, BGM, BUK, BIF, XPF, KHR, CAD, CVE, KYD, XAF, CLE, CLP, CLF, CNX, CNY, CNH, COP, COU, KMF, CDF, CRC, HRD, HRK, CUC, CUP, CYP, CZK, CSK, DKK, DJF, DOP, NLG, XCD, DDM, ECS, ECV, EGP, GQE, ERN, EEK, ETB, EUR, XBA, XEU, XBB, XBC, XBD, FKP, FJD, FIM, FRF, XFO, XFU, GMD, GEK, GEL, DEM, GHS, GHC, GIP, XAU, GRD, GTQ, GWP, GNF, GNS, GYD, HTG, HNL, HKD, HUF, IMP, ISK, ISJ, INR, IDR, IRR, IQD, IEP, ILS, ILP, ILR, ITL, JMD, JPY, JOD, KZT, KES, KWD, KGS, LAK, LVL, LVR, LBP, LSL, LRD, LYD, LTL, LTT, LUL, LUC, LUF, MOP, MKD, MKN, MGA, MGF, MWK, MYR, MVR, MVP, MLF, MTL, MTP, MRU, MRO, MUR, MXV, MXN, MXP, MDC, MDL, MCF, MNT, MAD, MAF, MZE, MZN, MZM, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NIC, NGN, KPW, NOK, OMR, PKR, XPD, PAB, PGK, PYG, PEI, PEN, PES, PHP, XPT, PLN, PLZ, PTE, GWE, QAR, XRE, RHD, RON, ROL, RUB, RUR, RWF, SVC, WST, SAR, RSD, CSD, SCR, SLL, XAG, SGD, SKK, SIT, SBD, SOS, ZAR, ZAL, KRH, KRW, KRO, SSP, SUR, ESP, ESA, ESB, XDR, LKR, SHP, XSU, SDD, SDG, SDP, SRD, SRG, SZL, SEK, CHF, SYP, STN, STD, TVD, TJR, TJS, TZS, XTS, THB, XXX, TPE, TOP, TTD, TND, TRY, TRL, TMT, TMM, USD, USN, USS, UGX, UGS, UAH, UAK, AED, UYW, UYU, UYP, UYI, UZS, VUV, VES, VEB, VEF, VND, VNN, CHE, CHW, XOF, YDD, YER, YUN, YUD, YUM, YUR, ZWN, ZRN, ZRZ, ZMW, ZMK, ZWD, ZWR, ZWL.exchange_rateStringThe invoice's exchange rate.
total_discountNumberThe total discounts applied to the total cost.
sub_totalNumberThe total amount being paid before taxes.
total_tax_amountNumberThe total amount being paid in taxes.
total_amountNumberThe invoice's total amount.
balanceNumberThe invoice's remaining balance.
paymentsArrayArray of
Payment object IDs.line_itemsArrayintegration_paramsObjectlinked_account_paramsObjectPOST v1/invoices
JSON
{"model": {"contact": "3fa85f64-5717-4562-b3fc-2c963f66afa6","number": "string","issue_date": "2023-05-26T22:33:53.278Z","due_date": "2023-05-26T22:33:53.278Z","paid_on_date": "2023-05-26T22:33:53.278Z","memo": "string","company": "3fa85f64-5717-4562-b3fc-2c963f66afa6","exchange_rate": "string","total_discount": 0,"sub_total": 0,"total_tax_amount": 0,"total_amount": 0,"balance": 0,"payments": ["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"line_items": [{"remote_id": "8765432","description": "Pickleball lessons","unit_price": 50,"quantity": 1,"total_amount": 50,"currency": "USD","exchange_rate": "2.9","item": "5b3c1341-a20f-4e51-b72c-f3830a16c97b","account": "cd0f32d4-a493-11ec-b909-0242ac120002","tracking_category": "b38c59b0-a9d7-4740-b1ee-5436c6751e3d","tracking_categories": ["b38c59b0-a9d7-4740-b1ee-5436c6751e3d","9b840d2-686a-465a-8a8e-7b028498f8e4","a47e11b6-c73b-4a0c-be31-130fc48177fa"],"company": "595c8f97-2ac4-45b7-b000-41bdf43240b5"}]}}
Response
JSON
{"model": {"id": "9871b4a9-f5d2-4f3b-a66b-dfedbed42c46","type": "ACCOUNTS_RECEIVABLE","contact": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","number": "AIQ12546","issue_date": "2020-03-31T00:00:00Z","due_date": "2020-04-15T00:00:00Z","paid_on_date": "2020-04-01T00:00:00Z","memo": "Weekly Payment","company": "595c8f97-2ac4-45b7-b000-41bdf43240b5","currency": "USD","exchange_rate": "2.9","total_discount": 0,"sub_total": 100,"total_tax_amount": 5,"total_amount": 105,"balance": 105,"remote_updated_at": "2020-04-01T00:00:00Z","tracking_categories": ["7dc5ca17-d311-44cd-9ce0-333080367a18","6aa0700c-48e1-4c4a-8162-02e6a582df05","8c933d61-8f5b-4360-ac0c-c9dc87bee763"],"payments": ["b26fd49a-cbae-470a-a8f8-bcbc119e0390"],"line_items": [{"id": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","remote_id": "8765432","description": "Pickleball lessons","unit_price": 50,"quantity": 1,"total_amount": 50,"currency": "USD","exchange_rate": "2.9","item": "5b3c1341-a20f-4e51-b72c-f3830a16c97b","account": "cd0f32d4-a493-11ec-b909-0242ac120002","tracking_category": "b38c59b0-a9d7-4740-b1ee-5436c6751e3d","tracking_categories": ["b38c59b0-a9d7-4740-b1ee-5436c6751e3d","9b840d2-686a-465a-8a8e-7b028498f8e4","a47e11b6-c73b-4a0c-be31-130fc48177fa"],"company": "595c8f97-2ac4-45b7-b000-41bdf43240b5",Show advanced fields}]}}
Field support by platform
Microsoft Dynamics 365 Business Central
Merge supports Passthrough Requests to this platform's API
Supported POST Model Parameters
contactStringRequired
currencyEnumOptional
due_dateStringOptional
issue_dateStringOptional
numberStringOptional
remote_idStringOptional
remote_updated_atStringOptional
total_amountNumberOptional
total_discountNumberOptional
total_tax_amountNumberOptional
typeEnumRequired
Additional POST Parameters
integration_paramsObjectRequired
company_idStringRequired
NetSuite
Merge supports Passthrough Requests to this platform's API
Supported POST Model Parameters
balanceNumberOptional
contactStringOptional
currencyEnumOptional
due_dateStringOptional
issue_dateStringOptional
memoStringOptional
numberStringOptional
paid_on_dateStringOptional
remote_idStringOptional
remote_updated_atStringOptional
sub_totalNumberOptional
total_amountNumberOptional
total_discountNumberOptional
total_tax_amountNumberOptional
typeEnumOptional
Additional POST Parameters
companyStringRequired
QuickBooks Online
Merge supports Passthrough Requests to this platform's API
Supported POST Model Parameters
balanceNumberOptional
contactStringRequired
currencyEnumOptional
due_dateStringOptional
exchange_rateStringOptional
issue_dateStringOptional
line_itemsInvoiceLineItem[]remote_idstringdescriptionstringunit_pricenumberquantitynumbertotal_amountnumbercurrencystringexchange_ratestringitemstringaccountstringtracking_categorystringtracking_categoriesarraycompanystringidstringfield_mappingsobjectmodified_atstringnumberStringOptional
remote_idStringOptional
remote_updated_atStringOptional
total_amountNumberOptional
typeEnumRequired
Sage Intacct
Merge supports Passthrough Requests to this platform's API
Supported POST Model Parameters
balanceNumberOptional
contactStringOptional
currencyEnumOptional
due_dateStringOptional
exchange_rateStringOptional
issue_dateStringOptional
memoStringOptional
numberStringOptional
paid_on_dateStringOptional
remote_idStringOptional
remote_updated_atStringOptional
total_amountNumberOptional
typeEnumOptional
Additional POST Parameters
line_itemsObjectRequired
total_amountStringRequired
tracking_categoriesStringRequired
Xero
Merge supports Passthrough Requests to this platform's API
Supported POST Model Parameters
balanceNumberOptional
contactStringRequired
currencyEnumOptional
due_dateStringOptional
exchange_rateStringOptional
issue_dateStringOptional
memoStringOptional
numberStringOptional
remote_idStringOptional
remote_updated_atStringOptional
sub_totalNumberOptional
total_amountNumberOptional
total_tax_amountNumberOptional
typeEnumRequired
Additional POST Parameters
line_itemsObjectRequired
accountStringRequired
FreeAgent
FreshBooks
Hint: Use the /linked-accounts endpoint to pull platform support information.
GET
/invoices/{id}
Returns an Invoice object with the given id.
Header Parameters
AuthorizationStringRequired
Token-based authentication with required prefix "Bearer"
X-Account-TokenStringRequired
Token identifying the end user.
Query & Path Parameters
expandStringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
idStringRequired
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
remote_fieldsStringOptional
Deprecated. Use show_enum_origins.
show_enum_originsStringOptional
Which fields should be returned in non-normalized form.
Response
JSON
{"id": "9871b4a9-f5d2-4f3b-a66b-dfedbed42c46","type": "ACCOUNTS_RECEIVABLE","contact": "022a2bef-57e5-4def-8ed2-7c41bd9a5ed8","number":