---
title: "Get a pre-authorization by ID"
method: GET
path: "/tokenized-payment/v1/pre-auths/{id}"
tags: ["Pre-Auth"]
---

# Get a pre-authorization by ID

`GET /tokenized-payment/v1/pre-auths/{id}`

Returns the current state of a pre-authorization. Use this to poll for status transitions after create, capture, or void operations.

## Path parameters

- `id` string, required

## Response `200`

Pre-auth found and returned.

- PreAuthResponseDto
  - `id` string, required — Pre-authorization UUID.
  - `merchantRef` string, required — Merchant's reference ID supplied at creation.
  - `status` 'PENDING' | 'AUTHORIZED' | 'CAPTURE_INITIATED' | 'CAPTURED' | 'VOIDED' | 'DECLINED' | 'EXPIRED', required — Lifecycle state of the pre-authorization.
  - `amount` number, required — Hold amount in major currency units.
  - `currency` string, required — 3-letter ISO currency code.
  - `orderUuid` string, nullable, required — UUID of the settled order. Non-null after capture.
  - `orderStatus` string, nullable, required — Status of the settled order. Non-null after capture.
  - `failureReason` string, nullable, required — Failure reason if the pre-auth was declined or expired.
  - `merchantMetadata` object, nullable, required — Merchant-supplied metadata stored verbatim at creation.
  - `createdAt` string, required — ISO 8601 creation timestamp.
  - `updatedAt` string, required — ISO 8601 last-updated timestamp.

## Other responses

- `400` — The provided ID is not in a valid format.
- `401` — Missing or invalid merchant JWT.
- `404` — Pre-authorization not found or belongs to a different merchant.

---

[API](https://skmtc.net/shopback/apis/online-payments-api.md) · [All operations](https://skmtc.net/shopback/apis/online-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopback/online-payments-api/revisions/160fc287769e/schema)