---
title: "This will return a wizard_session object."
method: GET
path: "/sessions/{transaction-id}"
tags: ["Sessions API"]
---

# This will return a wizard_session object.

`GET /sessions/{transaction-id}`

## Path parameters

- `transaction-id` string, required

## Response `200`

Request successfully processed

- WizardSessionObject
  - `id` string — Internal identifier.
  - `transaction` string — Public transaction identifier.
  - `wizard_session_key` string — Key to start the wizard
  - `product` 'xs2a_verify' | 'xs2a_risk' | 'xs2a_pay' | 'xs2a_api' — The name of the xs2a product.
  - `parameters` object — An array which contains the current wizard configuration.
  - `last_error` 'accounts_failed' | 'age_verification_not_confirmed' | 'authorized_person' | 'balance_failed' | 'bank_code_unknown' | 'client_aborted' | 'client_not_started' | 'consent_invalid' | 'country_id_invalid' | 'forced_transport_disabled' | 'init_failed' | 'login_blacklisted' | 'login_failed' | 'login_next_failed' | 'max_login_tries' | 'max_tan_tries' | 'no_compatible_accounts' | 'no_transports_found' | 'pinned_holder_not_found' | 'pinned_iban_not_found' | 'pp_not_checked' | 'session_expired' | 'security_setting_rejection' | 'standing_orders_failed' | 'tech_error' | 'testmode_error' | 'token_mismatch' | 'transaction_failed' | 'turnovers_failed' | 'tx_rx_iban_equal' | 'validation_failed' | 'wrong_tan' — The last occurred error. This is overwritten, if another error occurs. You can find detailed explanations of the errors [here](https://guide.xs2a.com/xs2a/integration-cs/additional-guides/errorcodes).
  - `testmode` boolean — true if this session runs in testmode. false otherwise.
  - `finished` boolean — true if this session was finished successfully. false if not or still running.
  - `current_step` 'WizardLoginStep' | 'WizardLoginNextStep' | 'WizardAccountsStep' | 'WizardDataStep' | 'WizardTanStep' | 'WizardScaStep' | 'WizardIrpaStep' | 'WizardAutoSubmitStep' | 'WizardFinishStep' | 'WizardStartStep' | 'WizardShowcaseStep' | 'WizardPreAccountsStep' | 'WizardPreDataStep' | 'WizardPreLoginStep' | 'WizardOauthRedirect' | 'WizardOauthRedirectNok' | 'RiskUpload' — The current wizard step of this session.
  - `created_at` string — Date of creation (YYYY-MM-DD HH:MM:SS)
  - `object` string — String with content 'wizard_session'

## 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
- `422` — Validation failed Something is wrong with the user input
- `500` — An internal server problem occurred

---

[API](https://skmtc.dev/xs2a/apis/xs2a-api.md) · [All operations](https://skmtc.dev/xs2a/apis/xs2a-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xs2a/xs2a-api/revisions/ae5fbc5feee3/schema)