---
updatedAt: 2026-08-26T23:00:31.000Z
agentTools:
  projectIndex: https://apidocs.taxbit.com/llms.txt
---

# Get Austria KESt withholding for an account

Retrieve an account's year-to-date Austria KESt (27.5%) withholding balance in EUR, optionally with the contribution of a single transaction. The account must use the austria disposition method.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v1/withholding/austria": {
      "get": {
        "description": "Retrieve an account's year-to-date Austria KESt (27.5%) withholding balance in EUR, optionally with the contribution of a single transaction. The account must use the austria disposition method.",
        "operationId": "WithholdingController_getAustriaWithholding",
        "parameters": [
          {
            "name": "tax_year",
            "required": false,
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 2025
            },
            "description": "Calendar year (Europe/Vienna) to scope the summary to. Defaults to the transaction year when transaction_id is supplied, otherwise the current year."
          },
          {
            "name": "transaction_id",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "example": "tx_sell_456"
            },
            "description": "Your system's unique identifier for a transaction. When supplied, the response includes that transaction's attribution and the summary is scoped to its tax year."
          },
          {
            "name": "account_id",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "example": "Account1234"
            },
            "description": "Your system's unique identifier for the account. Required unless x-user-id is supplied."
          }
        ],
        "responses": {
          "200": {
            "description": "Austria withholding summary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AustriaWithholdingResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "summary": {
                        "year_to_date_balance": "41.25",
                        "latest_transaction_datetime": "2025-03-14T10:15:00Z"
                      },
                      "transaction": {
                        "change_in_balance": "-13.75",
                        "transaction_datetime": "2025-03-14T10:15:00Z",
                        "transaction_id": "tx_sell_456"
                      },
                      "tax_year": 2025,
                      "fiat_asset": {
                        "code": "EUR",
                        "name": "Euro",
                        "symbol": "€",
                        "type": "Fiat",
                        "uuid": "b7a005b5-f4d5-44ea-ae80-d4f9e8313558"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "message": "Unauthorized Error"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "The account does not use the austria disposition method, or tax_year does not match the year of transaction_id",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "error": "Conflict",
                      "message": "Account Account1234 is not configured for Austria reporting"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "examples": {
                  "default": {
                    "summary": "Example",
                    "value": {
                      "message": "Too Many Requests"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Get Austria KESt withholding for an account",
        "tags": [
          "Withholding"
        ]
      }
    }
  },
  "info": {
    "title": "API",
    "description": "",
    "version": "1.2.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.multi1.enterprise.taxbit.com"
    },
    {
      "url": "https://api.eutax1.enterprise.taxbit.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "AustriaWithholdingResponseDto": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "object",
            "properties": {
              "year_to_date_balance": {
                "type": "string",
                "description": "EUR KESt (27.5%) withholding balance for the tax year to date, after loss compensation.",
                "example": "41.25"
              },
              "latest_transaction_datetime": {
                "type": "string",
                "format": "date-time",
                "description": "Datetime of the latest transaction included in the balance. Null when no Austria calculation has run.",
                "nullable": true,
                "example": "2025-03-14T10:15:00Z"
              }
            },
            "required": [
              "year_to_date_balance",
              "latest_transaction_datetime"
            ],
            "additionalProperties": false
          },
          "transaction": {
            "type": "object",
            "properties": {
              "change_in_balance": {
                "type": "string",
                "description": "Signed EUR contribution of this transaction to the year-to-date withholding balance.",
                "example": "-13.75"
              },
              "transaction_datetime": {
                "type": "string",
                "format": "date-time",
                "example": "2025-03-14T10:15:00Z"
              },
              "transaction_id": {
                "type": "string",
                "description": "Your system's unique identifier for the transaction.",
                "nullable": true,
                "example": "tx_sell_456"
              }
            },
            "required": [
              "change_in_balance",
              "transaction_datetime",
              "transaction_id"
            ],
            "description": "Per-transaction attribution for the requested transaction_id. Null when transaction_id was not supplied or has not been calculated yet.",
            "nullable": true,
            "additionalProperties": false
          },
          "tax_year": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Calendar year (Europe/Vienna) the summary is scoped to.",
            "example": 2025
          },
          "fiat_asset": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "Asset code.",
                "example": "EUR"
              },
              "name": {
                "type": "string",
                "example": "Euro"
              },
              "symbol": {
                "type": "string",
                "example": "€"
              },
              "type": {
                "type": "string",
                "description": "Asset type.",
                "example": "Fiat"
              },
              "uuid": {
                "format": "uuid",
                "description": "Asset UUID in the Taxbit system.",
                "type": "string",
                "example": "b7a005b5-f4d5-44ea-ae80-d4f9e8313558"
              }
            },
            "required": [
              "code",
              "type"
            ],
            "additionalProperties": false,
            "description": "Fiat asset the balance is denominated in. Null when no Austria calculation has run.",
            "nullable": true
          }
        },
        "required": [
          "summary",
          "transaction",
          "tax_year",
          "fiat_asset"
        ],
        "additionalProperties": false
      },
      "ErrorResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "example": "Bad Request"
          },
          "message": {
            "type": "string",
            "example": "Validation failed"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ]
}
```