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
id
UUIDremote_id
StringThe third-party API ID of the matching object.
created_at
DateTime (ISO 8601)The datetime that this object was created by Merge.
modified_at
DateTime (ISO 8601)The datetime that this object was modified by Merge.
name
StringThe income statement's name.
currency
EnumThe 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. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.company
UUIDThe company the income statement belongs to.
start_period
DateTime (ISO 8601)The income statement's start period.
end_period
DateTime (ISO 8601)The income statement's end period.
income
ReportItem[]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_id
StringThe third-party API ID of the matching object.
created_at
DateTime (ISO 8601)The datetime that this object was created by Merge.
modified_at
DateTime (ISO 8601)The datetime that this object was modified by Merge.
name
StringThe report item's name.
value
NumberThe report item's value.
sub_items
Objectcompany
UUIDThe company the report item belongs to.
remote_was_deleted
BooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
cost_of_sales
ReportItem[]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_id
StringThe third-party API ID of the matching object.
created_at
DateTime (ISO 8601)The datetime that this object was created by Merge.
modified_at
DateTime (ISO 8601)The datetime that this object was modified by Merge.
name
StringThe report item's name.
value
NumberThe report item's value.
sub_items
Objectcompany
UUIDThe company the report item belongs to.
remote_was_deleted
BooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
gross_profit
NumberThe revenue minus the cost of sale.
operating_expenses
ReportItem[]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_id
StringThe third-party API ID of the matching object.
created_at
DateTime (ISO 8601)The datetime that this object was created by Merge.
modified_at
DateTime (ISO 8601)The datetime that this object was modified by Merge.
name
StringThe report item's name.
value
NumberThe report item's value.
sub_items
Objectcompany
UUIDThe company the report item belongs to.
remote_was_deleted
BooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
net_operating_income
NumberThe revenue minus the operating expenses.
non_operating_expenses
ReportItem[]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_id
StringThe third-party API ID of the matching object.
created_at
DateTime (ISO 8601)The datetime that this object was created by Merge.
modified_at
DateTime (ISO 8601)The datetime that this object was modified by Merge.
name
StringThe report item's name.
value
NumberThe report item's value.
sub_items
Objectcompany
UUIDThe company the report item belongs to.
remote_was_deleted
BooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
net_income
NumberThe gross profit minus the total expenses.
remote_was_deleted
BooleanIndicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
field_mappings
Objectremote_data
RemoteData[]The RemoteData object
The
RemoteData
object is used to represent the full data pulled from the third-party API for an object.Properties
path
StringThe third-party API path that is being called.
data
AnyThe data returned from the third-party for this object in its original, unnormalized format.
GET
/income-statements
https://api.merge.dev/api/accounting/v1/income-statements
US
EU
APAC
Returns a list of IncomeStatement
objects.
Query & path parameters
company_id
StringOptional
If provided, will only return income statements for this company.
created_after
DateTime (ISO 8601)Optional
If provided, will only return objects created after this datetime.
created_before
DateTime (ISO 8601)Optional
If provided, will only return objects created before this datetime.
cursor
StringOptional
The pagination cursor value.
expand
StringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
include_deleted_data
BooleanOptional
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
include_remote_data
BooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
include_shell_data
BooleanOptional
Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).
modified_after
DateTime (ISO 8601)Optional
If provided, only objects synced by Merge after this date time will be returned.
modified_before
DateTime (ISO 8601)Optional
If provided, only objects synced by Merge before this date time will be returned.
page_size
IntegerOptional
Number of results to return per page.
remote_id
StringOptional
The API provider's ID for the given object.
Field support by integration
See all supported fieldsUse the /linked-accounts endpoint to pull platform support information
NetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
income
ReportItem[]remote_id
stringname
stringvalue
numbercompany
UUIDend_period
DateTime (ISO 8601)name
Stringstart_period
DateTime (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
income
ReportItem[]remote_id
stringname
stringvalue
numbersub_items
objectcurrency
Enumend_period
DateTime (ISO 8601)gross_profit
Numbername
Stringnet_income
Numbernet_operating_income
Numberremote_data
RemoteData[]path
stringdata
stringstart_period
DateTime (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
income
ReportItem[]remote_id
stringname
stringvalue
numbersub_items
objectend_period
DateTime (ISO 8601)gross_profit
Numbername
Stringnet_income
Numbernet_operating_income
Numberremote_data
RemoteData[]path
stringdata
stringstart_period
DateTime (ISO 8601)Zoho Books
GET
/income-statements/{id}
https://api.merge.dev/api/accounting/v1/income-statements/{id}
US
EU
APAC
Returns an IncomeStatement
object with the given id
.
Query & path parameters
expand
StringOptional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
id
UUIDRequired
include_remote_data
BooleanOptional
Whether to include the original data Merge fetched from the third-party to produce these models.
Field support by integration
See all supported fieldsUse the /linked-accounts endpoint to pull platform support information
NetSuite
On top of normalized Common Models, Merge also supports Passthrough Requests and deleted data detection for this platform's API
Supported Response Fields
income
ReportItem[]remote_id
stringname
stringvalue
numbercompany
UUIDend_period
DateTime (ISO 8601)name
Stringstart_period
DateTime (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
income
ReportItem[]remote_id
stringname
stringvalue
numbersub_items
objectcurrency
Enumend_period
DateTime (ISO 8601)gross_profit
Numbername
Stringnet_income
Numbernet_operating_income
Numberremote_data
RemoteData[]path
stringdata
stringstart_period
DateTime (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
income
ReportItem[]remote_id
stringname
stringvalue
numbersub_items
objectend_period
DateTime (ISO 8601)gross_profit
Numbername
Stringnet_income
Numbernet_operating_income
Numberremote_data
RemoteData[]path
stringdata
stringstart_period
DateTime (ISO 8601)Zoho Books