---
title: "Wait for transaction by hash"
method: GET
path: "/transactions/wait_by_hash/{txn_hash}"
tags: ["Transactions"]
---

# Wait for transaction by hash

`GET /transactions/wait_by_hash/{txn_hash}`

Same as /transactions/by_hash, but will wait for a pending transaction to be committed. To be used as a long
poll optimization by clients, to reduce latency caused by polling. The "long" poll is generally a second or
less but dictated by the server; the client must deal with the result as if the request was a normal
/transactions/by_hash request, e.g., by retrying if the transaction is pending.

## Path parameters

- `txn_hash` string, required

## Response `200`

- Transaction — unresolved $ref

## Other responses

- `400`
- `403`
- `404`
- `410`
- `500`
- `503`

## Changes

- **2026-06-18** `4a94534afca7` — 1 breaking, 1 info
  - added `#/components/schemas/BlockMetadataExtension_BlockMetadataExtensionRandomnessAndDecPayload` to the `oneOf[#/components/schemas/Transaction_BlockMetadataTransaction]/allOf[#/components/schemas/BlockMetadataTransaction]/block_metadata_extension/allOf[#/components/schemas/BlockMetadataExtension]/` response property `oneOf` list for the response status `200`
  - added `v3` discriminator mapping keys to the `oneOf[#/components/schemas/Transaction_BlockMetadataTransaction]/allOf[#/components/schemas/BlockMetadataTransaction]/block_metadata_extension/allOf[#/components/schemas/BlockMetadataExtension]/` response property for the response status `200`
- **2026-06-01** `3df5940592fd` — 2 info
  - added the optional property `oneOf[#/components/schemas/Transaction_PendingTransaction]/allOf[#/components/schemas/PendingTransaction]/txn_limits_request` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Transaction_UserTransaction]/allOf[#/components/schemas/UserTransaction]/txn_limits_request` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/aptoslabs/apis/aptos-node-api/changes/transactions/wait_by_hash/:txn_hash/get.md)

---

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