Accountant - Income Statement

Retrieve Income Statement Data

To retrieve Income Statement data perform a GET against the following url:

https://integrationapi.smeasy.co.za/api/accountant/incomestatement

The following query string parameters can be provided to filter the resulting list of income statement data:

parameter	Comment
start	date in the format YYYY-MM-DD (example: 2022-05-12). Will return income statement data greater than or equal to `start` date
end	date in the format YYYY-MM-DD (example: 2022-07-24). Will return income statement data less than or equal to `end` date

A successful response will return a 200 HTTP status code and the following json result.

[
	{
		"amount": 5000.0,
		"description": "Gross profit/(loss)",
		"childItems": [
			{
				"amount": 5000.0,
				"description": "Revenue",
				"childItems": []
			},
			{
				"amount": 0.0,
				"description": "Cost of sales",
				"childItems": []
			}
		]
	},
	{
		"amount": 5000.0,
		"description": "Profit/(loss) before tax",
		"childItems": [
			{
				"amount": 0.0,
				"description": "Other income",
				"childItems": []
			},
			{
				"amount": 0.0,
				"description": "Distribution costs",
				"childItems": []
			},
			{
				"amount": 0.0,
				"description": "Administrative expenses",
				"childItems": []
			},
			{
				"amount": 0.0,
				"description": "Other expenses",
				"childItems": []
			},
			{
				"amount": 0.0,
				"description": "Finance costs",
				"childItems": []
			}
		]
	},
	{
		"amount": 5000.0,
		"description": "Profit/(loss) for the year",
		"childItems": [
			{
				"amount": 0.0,
				"description": "Income tax expense",
				"childItems": []
			}
		]
	},
	{
		"amount": 24512.74,
		"description": "Retained earnings/(assessed loss) at start of the period",
		"childItems": []
	},
	{
		"amount": 29512.74,
		"description": "Retained earnings/(assessed loss) at the end of period",
		"childItems": [
			{
				"amount": 0.0,
				"description": "Dividends",
				"childItems": []
			}
		]
	}
]

Notes

start and end parameters are not required but it is advisable to use them to reduce the set of data being queried and returned.

For large companies with large amounts of income statement data response times will be affected negatively by requesting ALL income statement data.