v1

latestOpenAPI 3.0.02026-07-2412592575.3 KB
tax

Retrieve transactions to help answer SA105 - the Self Assessment questions for properties for HMRC

Requires tax:read scope.

get/tax

Query parameters

startDatestring date required

The date to get transactions from

endDatestring date required

The date to get transactions to

projectIdstring

The project ID the transactions belong to

accountIdstring

The account ID the transactions belong to

Response

Successful Tax Response

metaobject

Example response

{
  "data": {
    "dateFrom": "2018-04-06",
    "dateTo": "2019-04-05",
    "taxReturn": {
      "sa105": {
        "income": {
          "total": {
            "value": 1500000,
            "majorUnits": 15000,
            "minorUnits": 0,
            "currency": "GBP"
          },
          "details": [
            {
              "amount": {
                "value": 1500000,
                "majorUnits": 15000,
                "minorUnits": 0,
                "currency": "GBP"
              },
              "category": "income.rent"
            }
          ]
        },
        "expenditure": {
          "total": {
            "value": 300000,
            "majorUnits": 3000,
            "minorUnits": 0,
            "currency": "GBP"
          },
          "details": [
            {
              "amount": {
                "value": 200000,
                "majorUnits": 2000,
                "minorUnits": 0,
                "currency": "GBP"
              },
              "category": "expenditure.professional"
            },
            {
              "amount": {
                "value": 100000,
                "majorUnits": 1000,
                "minorUnits": 0,
                "currency": "GBP"
              },
              "category": "expenditure.maintenance"
            }
          ]
        },
        "taxableIncome": {
          "total": {
            "value": 1200000,
            "majorUnits": 12000,
            "minorUnits": 0,
            "currency": "GBP"
          }
        }
      }
    }
  }
}