---
title: "Get turnover booking_text"
method: GET
path: "/risks/{transaction-id}/accountSnapshot/?format=json2"
tags: ["Additional Settings"]
---

# Get turnover booking_text

`GET /risks/{transaction-id}/accountSnapshot/?format=json2`

## Request

- Base URL: `https://api.xs2a.com/v1`
- URL: `https://api.xs2a.com/v1/risks/{transaction-id}/accountSnapshot/?format=json2`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/xs2a/apis/xs2a-api/docs/risks/:transaction-id/accountSnapshot/%3Fformat=json2/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a turnover booking text from a xs2a.account_snapshot

## Path parameters

- `transaction-id` string, required

## Query parameters

- `format` 'json2'

## Response `200`

Request successfully processed

- AccountStatementBookingText[]: This response describes the JSON2 response of this endpoint
  - `account` object
    - `holder` string: Name of the account holder
    - `description` string: Name of the account
    - `iban` string: IBAN of the account
    - `bic` string: BIC of the account
    - `country_id` 'DE' | 'AT' | 'CH': The 2-letter country code
    - `joint_account` boolean: Indicates whether this is a joint account
  - `balance` object
    - `available` number, float, nullable: The available amount. This can be null, if the available amount is not known.
    - `limit` number, float, nullable: The limit of the account. This can be null, if the limit is not known.
    - `balance` number, float: The current account balance.
    - `currency` 'EUR' | 'CHF': The id of the currency to be used.
    - `date` string: The date the balance was seen on.
  - `turnovers` object: array of turnovers
    - `turnovers` TurnoverBookingText[]
      - `booking_date` string: The booking date.
      - `amount` number, float: The turnover amount. Negative for expenditures.
      - `currency` 'EUR' | 'CHF': The id of the currency to be used.
      - `purpose` string[]: A string array of purpose lines. The contents vary from bank to bank.
      - `booking_text` string: The booking text of the purpose. This is not always present.
      - `counter_iban` string: The counter IBAN of the booking. This is not always present.
      - `counter_bic` string: The counter BIC of the booking. This is not always present.
      - `counter_holder` string: The counter holder of the booking. This is not always present.
      - `prebooked` boolean: True, if the turnover has not been booked yet
      - `canceled` boolean: True, if the turnover has been canceled.
      - `tags` string[]: An array of strings of tags for this turnover. Find all possible tags here: https://manage.xs2a.com/documentation/tags
      - `category_id` string: The ID of the category found for this turnover. The structure of this `category_id` string is hierarchical, meaning, the more numbers there are, the more detailed the category is. For example, while `K.1` means "expenses for wholesale and retail trade", some turnovers might be categorized more detailed as `K.1.1` ("expenses in retail stores"), or even as `K.1.1.1` ("groceries full-range trader"). You can find the complete list of categories [here](https://manage.xs2a.com/documentation/categories). **NOTE**: As new categories are introduced and the categorization itself is improved constantly, it is possible that the same turnover can be categorized with a different (more detailed) `category_id` at a future point in time. You should develop your application in such a way, that, for example, if your logic relies on something happening when a `category_id` is `K.1.1`, but you get `K.1.2` for which no logic is in place (because it might be a new `category_id` or the turnover is now categorized more detailed), **you should always fall back to the next higher level category**, in this case `K.1`. This way, your logic can still handle the turnover based on a more general category, while not throwing an error.
      - `creditor_id` string: The ID of the creditor.
      - `new` boolean: True, if this turnover is new since the last sync.
    - `date` string: Date of the account snapshot
    - `days` integer: Indicates how many days the account snapshot includes
    - `filters` string[]: Array of filters applied

## Other responses

- `401`: Authentication failed API key missing or not valid
- `403`: Forbidden Access blocked
- `404`: Product not enabled or Not found The requested object does not exist on the server
- `410`: The object has been deleted intentionally
- `422`: Validation failed Something is wrong with the user input
- `500`: An internal server problem occurred

## Changes

- **2026-09-01** `ae5fbc5feee3`: 4 info
  - removed the `ES` enum value from the `items/account/country_id` response property for the response status `200`
  - removed the `FR` enum value from the `items/account/country_id` response property for the response status `200`
  - removed the `GB` enum value from the `items/account/country_id` response property for the response status `200`
  - removed the `IT` enum value from the `items/account/country_id` response property for the response status `200`

[Operation history](https://skmtc.dev/xs2a/apis/xs2a-api/changes/risks/:transaction-id/accountSnapshot/%3Fformat=json2/get.md)

---

[API](https://skmtc.dev/xs2a/apis/xs2a-api.md) - [All operations](https://skmtc.dev/xs2a/apis/xs2a-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xs2a/apis/xs2a-api/revisions/ae5fbc5feee3?raw)