Income Statements
The
IncomeStatement object is used to represent a company’s income, the cost of sales, operating expenses, and other non-operating expenses. The object also includes other important values like gross profit, gross operating profit, and net income. This represents a period of time (month, quarter, or year).Properties
idUUIDRequired
remote_idStringOptional
The third-party API ID of the matching object.
nameStringOptional
The income statement's name.
currencyEnumOptional
The income statement'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. In cases where there is no clear mapping, the original value passed through will be returned.companyUUIDOptional
The company the income statement belongs to.
start_periodDateTime (ISO 8601)Optional
The income statement's start period.
end_periodDateTime (ISO 8601)Optional
The income statement's end period.
incomeReportItem[]Required
The ReportItem object
The
ReportItem object is used to represent a report item for a Balance Sheet, Cash Flow Statement or Profit and Loss Report.Properties
remote_idStringOptional
The third-party API ID of the matching object.
nameStringOptional
The report item's name.
valueNumberOptional
The report item's value.
sub_itemsObjectRequired
companyUUIDOptional
The company the report item belongs to.
created_atDateTime (ISO 8601)Required
modified_atDateTime (ISO 8601)Required
This is the datetime that this object was last updated by Merge
cost_of_salesReportItem[]Required
The ReportItem object
The
ReportItem object is used to represent a report item for a Balance Sheet, Cash Flow Statement or Profit and Loss Report.Properties
remote_idStringOptional
The third-party API ID of the matching object.
nameStringOptional
The report item's name.
valueNumberOptional
The report item's value.
sub_itemsObjectRequired
companyUUIDOptional
The company the report item belongs to.
created_atDateTime (ISO 8601)Required
modified_atDateTime (ISO 8601)Required
This is the datetime that this object was last updated by Merge
gross_profitNumberOptional
The revenue minus the cost of sale.
operating_expensesReportItem[]Required
The ReportItem object
The
ReportItem object is used to represent a report item for a Balance Sheet, Cash Flow Statement or Profit and Loss Report.Properties
remote_idStringOptional
The third-party API ID of the matching object.
nameStringOptional
The report item's name.
valueNumberOptional
The report item's value.
sub_itemsObjectRequired
companyUUIDOptional
The company the report item belongs to.
created_atDateTime (ISO 8601)Required
modified_atDateTime (ISO 8601)Required
This is the datetime that this object was last updated by Merge
net_operating_incomeNumberOptional
The revenue minus the operating expenses.
non_operating_expensesReportItem[]Required
The ReportItem object
The
ReportItem object is used to represent a report item for a Balance Sheet, Cash Flow Statement or Profit and Loss Report.Properties
remote_idStringOptional
The third-party API ID of the matching object.
nameStringOptional
The report item's name.
valueNumberOptional
The report item's value.
sub_itemsObjectRequired
companyUUIDOptional
The company the report item belongs to.
created_atDateTime (ISO 8601)Required
modified_atDateTime (ISO 8601)Required
This is the datetime that this object was last updated by Merge
net_incomeNumberOptional
The gross profit minus the total expenses.
remote_was_deletedBooleanRequired
Indicates whether or not this object has been deleted in the third party platform.
created_atDateTime (ISO 8601)Required
modified_atDateTime (ISO 8601)Required
This is the datetime that this object was last updated by Merge
field_mappingsObjectOptional
remote_dataRemoteData[]Optional
GET
/income-statements
https://api.merge.dev/api/accounting/v1/income-statements
US
EU
Returns a list of IncomeStatement objects.
Query & Path Parameters
company_idStringOptional
If provided, will only return income statements for this company.
created_afterDateTime (ISO 8601)Optional
If provided, will only return objects created after this datetime.
created_beforeDateTime (ISO 8601)Optional
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.
modified_afterDateTime (ISO 8601)Optional
If provided, only objects synced by Merge after this date time will be returned.
modified_beforeDateTime (ISO 8601)Optional
If provided, only objects synced by Merge before this date time will be returned.
page_sizeIntegerOptional
Number of results to return per page.
remote_idStringOptional
The API provider's ID for the given object.
Field support by integration
See all supported fields
NetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
companyUUIDend_periodDateTime (ISO 8601)nameStringstart_periodDateTime (ISO 8601)
QuickBooks Online
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
currencyEnumend_periodDateTime (ISO 8601)gross_profitNumbernameStringnet_incomeNumbernet_operating_incomeNumberremote_dataRemoteData[]pathstringdatastringstart_periodDateTime (ISO 8601)
Xero
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
end_periodDateTime (ISO 8601)gross_profitNumbernameStringnet_incomeNumbernet_operating_incomeNumberremote_dataRemoteData[]pathstringdatastringstart_periodDateTime (ISO 8601)
FreshBooks
GET
/income-statements/{id}
https://api.merge.dev/api/accounting/v1/income-statements/{id}
US
EU
Returns an IncomeStatement object with the given id.
Query & Path Parameters
expandStringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
idUUIDRequired
include_remote_dataBooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
Field support by integration
See all supported fieldsNetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
companyUUIDend_periodDateTime (ISO 8601)nameStringstart_periodDateTime (ISO 8601)QuickBooks Online
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
currencyEnumend_periodDateTime (ISO 8601)gross_profitNumbernameStringnet_incomeNumbernet_operating_incomeNumberremote_dataRemoteData[]pathstringdatastringstart_periodDateTime (ISO 8601)Xero
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API.
Supported Response Fields
end_periodDateTime (ISO 8601)gross_profitNumbernameStringnet_incomeNumbernet_operating_incomeNumberremote_dataRemoteData[]pathstringdatastringstart_periodDateTime (ISO 8601)FreshBooks