---
title: "Read chain-authoritative transaction status"
method: GET
path: "/transactions/{hash}"
tags: ["Transactions"]
---

# Read chain-authoritative transaction status

`GET /transactions/{hash}`

## Request

- Base URL: `https://kellian.app/api/v1`
- URL: `https://kellian.app/api/v1/transactions/{hash}`
- Auth: none required

## Path parameters

- `hash` string, required

## Query parameters

- `chainId` integer: Compiled protocol release chain ID (Base 8453).
- `operationId` string: Optional correlation label returned verbatim; the receipt remains authoritative.
- `idempotencyKey` string: Optional replay correlation label returned verbatim; the receipt remains authoritative.
- `submittedAt` string, date-time

## Response `200`

Success

- union: Chain-authoritative transaction state with a durable recovery URL and minimal receipt proof. A missing or structurally incomplete receipt remains SUBMITTED; only a mined successful receipt becomes CONFIRMED and a mined reverted receipt becomes FAILED. CONFIRMED means mined, not finalized indexer economic projection.
  - object
    - `operationId` string, required: Stable client/server operation correlation identifier; not chain authority.
    - `idempotencyKey` string, required: Stable replay key for the originating mutation; not chain authority.
    - `state` 'SUBMITTED', required
    - `chainId` integer, required
    - `txHash` string, required
    - `submittedAt` string, date-time, required
    - `statusUrl` string, required
    - `receipt` unknown, required
  - object
    - `operationId` string, required: Stable client/server operation correlation identifier; not chain authority.
    - `idempotencyKey` string, required: Stable replay key for the originating mutation; not chain authority.
    - `state` 'CONFIRMED', required
    - `chainId` integer, required
    - `txHash` string, required
    - `blockNumber` string, required
    - `confirmedAt` string, date-time, required
    - `statusUrl` string, required
    - `receipt` object, required
      - `status` 'success', required
      - `blockNumber` string, required
      - `blockHash` string, required
      - `transactionIndex` string, required
  - object
    - `operationId` string, required: Stable client/server operation correlation identifier; not chain authority.
    - `idempotencyKey` string, required: Stable replay key for the originating mutation; not chain authority.
    - `state` 'FAILED', required
    - `chainId` integer, required: Compiled protocol release chain ID (Base 8453).
    - `txHash` string, required
    - `code` string, required
    - `detail` string, required
    - `retryable` boolean, required
    - `failedAt` string, date-time, required
    - `statusUrl` string, required
    - `receipt` object, required
      - `status` 'reverted', required
      - `blockNumber` string, required
      - `blockHash` string, required
      - `transactionIndex` string, required

## Other responses

- `400`: Error: one of INVALID_PAYLOAD, INVALID_CHAIN
- `500`: Error: one of INTERNAL_ERROR
- `503`: Error: one of SERVICE_UNAVAILABLE
- `default`: Error response (RFC 9457 Problem Details for HTTP APIs)

---

[API](https://skmtc.dev/problee/apis/kellian-consumer-api.md) · [All operations](https://skmtc.dev/problee/apis/kellian-consumer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/problee/apis/kellian-consumer-api/revisions/2b8254b0ec57?raw)