> For the complete documentation index, see [llms.txt](https://za.docs.rechtlogisch.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://za.docs.rechtlogisch.de/beta/retrieval/steuerkonto.md).

# Steuerkonto

Sandbox only

*Data type: ElsterKontoabfrage*

## Endpoints

{% hint style="info" %}
Only retrieval possible.

Tax account itself does not allow to list available tax numbers. The retrieval does not need to be confirmed. Therefore no `list`, nor `confirm` endpoints are present in `taxaccount` group.
{% endhint %}

### Single

For one tax number (or in Hessen for one tax-id).

`/v2/taxaccount/single`

### Batch

For multiple tax numbers (or in Hessen for multiple tax-ids).

`/v2/taxaccount/batch`

## Request Type

Which bookings to return. Enumerated list:

<table><thead><tr><th width="153.56158447265625">requestType</th><th></th></tr></thead><tbody><tr><td>I</td><td>Ist-Stand = Geleistete Zahlungen</td></tr><tr><td>O</td><td>Offene Beträge</td></tr><tr><td>ZS</td><td>Sollstellungen</td></tr></tbody></table>

{% hint style="warning" icon="triangle-exclamation" %}
Batch allows only tax numbers from one federal state.
{% endhint %}

{% hint style="info" %}
In Batch `requestType` can be set individually per entry (per tax number/per tax-id).
{% endhint %}

## Test tax numbers

The following tax numbers can be used in the test environment:

{% hint style="info" %}
Test tax numbers are usable with test certificate [test-softorg-pse.pfx](/beta/retrieval/steuerkonto.md) only. Using other test certificates will return an error.
{% endhint %}

### Hessen

2663087737850\
2663087863362\
2663087737876

### Bayern

9198011310010\
9198011310029\
9198011310037\
9198011310045\
9198011310053\
9198011310061\
9198011310088\
9198011310096\
9198011310118\
9198011310126\
9198011310193\
9198011310207\
9198011310215\
9198011310223\
9198011310290\
9198011310339\
9198011310347\
9198011310355\
9198011310363\
9198011310371\
9198011310398\
9198011310401

~~9198011310231~~ (is not available currently)
