ATO Lodgements (Firm)
GET {{baseUrl}}/sf/firm/lodgements?modifiedAfter&modifiedBefore
Will retrieve form lodgement history with the ATO for a firm.
API Scopes
The following API scopes can access this resource - investment - audit - smsf_partner
Response Body
| Key | Data Type | Description |
|---|---|---|
| amountDueOrRefundable | number | |
| form | String | Name of the form. returns either SMSF_ANNUAL_RETURNor ACTIVITY_STATEMENT |
| lodgementDateTime | Date | Date and time the form was lodged (UTC) |
| lodgementStatus | String | Status of the form |
| lodgingPartyFirm | String | Name of lodging party who is responsible for the form |
| lodgingPartyIndividual | String | Individuals name of lodging party who is responsible for the form |
| validatedDateTime | Date | Date and time the form was validated (UTC) |
| year | Date | Year of the form. format = YYYY |
Lodgement Statuses
| Status | Description |
|---|---|
| LODGED_ELE | Lodged electronically/manually |
| LODGED_REJ | Lodgment Rejected |
| VALIDATED | Form Validated |
| null | When the form is only prepared it will send status as null |
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
modifiedAfter | null | [optional] - UTC Time. | |
| Will only return results where lodgementDateTime or validatedDateTime is after this date | |||
modifiedBefore | null | [optional] - UTC Time. | |
| Will only return results where lodgementDateTime or validatedDateTime is before this date |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"lodgements":[{"form":"SMSF_ANNUAL_RETURN","lodgementDateTime":"2018-12-14T05:45:00.000+0000","lodgementStatus":"LODGED_ELE","lodgingPartyFirm":"ABC Accountants Pty Ltd","lodgingPartyIndividual":"Tokhi, Jeevan","validateDateTime":"2017-10-01T22:19:56.000+0000","year":2017},{"form":"SMSF_ANNUAL_RETURN","lodgementDateTime":"2018-10-24T05:39:10.000+0000","lodgementStatus":"LODGED_ELE","lodgingPartyFirm":"ABC Accountants Pty Ltd","lodgingPartyIndividual":"Tokhi, Jeevan","validateDateTime":"2018-09-17T00:16:42.000+0000","year":2018},{"form":"SMSF_ANNUAL_RETURN","lodgementDateTime":null,"lodgementStatus":"VALIDATED","lodgingPartyFirm":"ABC Accountants Pty Ltd","lodgingPartyIndividual":"Crofts, Matt","validateDateTime":"2019-08-20T02:12:14.000+0000","year":2019}]}