﻿# TRANSACTION_NOT_FOUND — transaction ID does not exist

The transaction ID supplied in the request does not correspond to an active transaction. The transaction may have been committed, rolled back, expired, or…

<em>cyoda-go version <a href="https://github.com/Cyoda-platform/cyoda-go/releases/tag/v0.6.2">0.6.2</a></em>

# errors.TRANSACTION_NOT_FOUND

## NAME

TRANSACTION_NOT_FOUND — no transaction with the given ID exists on this node.

## SYNOPSIS

HTTP: `404` `Not Found`. Retryable: `no`.

## DESCRIPTION

The transaction ID supplied in the request does not correspond to an active transaction. The transaction may have been committed, rolled back, expired, or may never have existed. Also occurs when a request is mis-routed to a node that never opened the transaction.

Not retryable. Transaction state (committed, rolled back, expired) determines whether the transaction existed.

## SEE ALSO

- errors
- errors.TRANSACTION_EXPIRED
- errors.TRANSACTION_NODE_UNAVAILABLE

## See also

- [`cyoda help errors`](/help/errors/) — Every error response from the Cyoda REST API carries a structured `errorCode` in the `properties` object. Multiple codes may share the same HTTP status. Programmatic handling keys on `errorCode`, not HTTP status.
- [`cyoda help errors TRANSACTION_EXPIRED`](/help/errors/transaction_expired/) — Transaction tokens are short-lived bearer tokens issued when a transaction is opened. This error fires when the token's `exp` claim is in the past at the time the proxy validates it. The transaction itself may still be active server-side, but the token is no longer valid for routing.
- [`cyoda help errors TRANSACTION_NODE_UNAVAILABLE`](/help/errors/transaction_node_unavailable/) — Transaction state is pinned to the node that opened it. If that node crashes or becomes unreachable while the transaction is in progress, subsequent requests using the transaction token are rejected with this error because the proxy cannot forward them to the owner.

## Raw formats

- [`/help/errors/transaction_not_found.json`](/help/errors/transaction_not_found.json) — full descriptor (matches `GET /help/{topic}` envelope)
- [`/help/errors/transaction_not_found.md`](/help/errors/transaction_not_found.md) — body only