Tax Information

Get Tax Information

get

Get data about tax calculations for the given entity in the given tax year.

Authorizations

Bearer

Query parameters

entityIdstring · uuidRequired

Unique entity identification in UUID format

entityTypestring · enumRequired

Type of the entity.

Possible values:

yearinteger · min: 1900 · max: 2100Required

Calendar year of the tax year

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /taxes/tax-information?entityId=123e4567-e89b-12d3-a456-426614174000&entityType=NATURAL_PERSON&year=1 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "taxpayerId": "123e4567-e89b-12d3-a456-426614174000",
  "year": 1,
  "lossPotBalances": {
    "stockLossPotBalance": 1,
    "otherLossPotBalance": 1
  },
  "incomeCoverage": {
    "incomeCoveredByStockLossPot": 1,
    "incomeCoveredByOtherLossPot": 1,
    "incomeCoveredByFsa": 1
  },
  "taxCalculations": {
    "totalGermanCit": 1,
    "totalSolidaritySurcharge": 1,
    "totalChurchTax": 1
  },
  "foreignTaxCredits": {
    "totalCreditedForeignTax": 1
  },
  "accountSummary": {
    "totalLossPotBalance": 1,
    "totalIncomeCovered": 1,
    "totalGermanTax": 1
  },
  "updatedAt": "2025-10-14T19:46:56.107Z"
}