Tax Information

Get Tax Information

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/taxes/tax-information

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

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

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

taxYearintegerRequired

Calendar year of the tax year

lossPotEquitiesnumber · decimalRequired

Balance of the STOCK loss pot

lossPotGeneralnumber · decimalRequired

Balance of the OTHER (general) loss pot

incomeCoveredEquitiesnumber · decimalRequired

Income covered by losses from the STOCK loss pot in this tax year

incomeCoveredGeneralnumber · decimalRequired

Income covered by losses from the OTHER loss pot in this tax year

usedFsanumber · decimalRequired

Income covered by the FSA (Saver's Allowance) in this tax year

withheldCapitalGainsTaxnumber · decimalRequired

Total German capital income tax calculated for the taxpayer in this tax year

withheldSolidarityTaxnumber · decimalRequired

Total German solidarity surcharge tax calculated for the taxpayer in this tax year

withheldChurchTaxnumber · decimalRequired

Total German church tax calculated for the taxpayer in this tax year

creditedForeignWithholdingTaxnumber · decimalRequired

Total foreign tax credited for the taxpayer in this tax year

400

Bad Request

application/json

404

Not Found

application/json

get

/taxes/tax-information

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: */*

{
  "taxYear": 1,
  "lossPotEquities": 1,
  "lossPotGeneral": 1,
  "incomeCoveredEquities": 1,
  "incomeCoveredGeneral": 1,
  "usedFsa": 1,
  "withheldCapitalGainsTax": 1,
  "withheldSolidarityTax": 1,
  "withheldChurchTax": 1,
  "creditedForeignWithholdingTax": 1
}