---
title: "Retrieves a transaction by its nonce value."
method: GET
path: "/api/v1/relayers/{relayer_id}/transactions/by-nonce/{nonce}"
tags: ["Relayers"]
---

# Retrieves a transaction by its nonce value.

`GET /api/v1/relayers/{relayer_id}/transactions/by-nonce/{nonce}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/openzeppelin/apis/openzeppelin-relayer-api/docs/api/v1/relayers/:relayer_id/transactions/by-nonce/:nonce/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `relayer_id` string, required
- `nonce` integer, required

## Response `200`

Relayer transaction retrieved successfully

- ApiResponseTransactionResponse
  - `data` union
    - EvmTransactionResponse
      - `confirmed_at` string
      - `created_at` string, required
      - `data` string
      - `from` string, required
      - `gas_limit` integer, nullable
      - `gas_price` string
      - `hash` string
      - `id` string, required
      - `is_canceled` boolean: Whether this transaction was cancelled by the user. While true and still in a non-terminal status, it is being replaced on-chain by a NOOP that consumes its nonce; it terminates as `canceled` once that NOOP mines.
      - `max_fee_per_gas` string
      - `max_priority_fee_per_gas` string
      - `nonce` integer
      - `relayer_id` string, required
      - `sent_at` string
      - `signature` EvmTransactionDataSignature
        - `r` string, required
        - `s` string, required
        - `sig` string, required
        - `v` integer, required
      - `speed` 'fastest' | 'fast' | 'average' | 'safeLow'
      - `status` 'canceled' | 'pending' | 'sent' | 'submitted' | 'mined' | 'confirmed' | 'failed' | 'expired', required
      - `status_reason` string, nullable
      - `to` string
      - `value` string, required
    - SolanaTransactionResponse
      - `confirmed_at` string
      - `created_at` string, required
      - `id` string, required
      - `instructions` SolanaInstructionSpec[]
        - `accounts` SolanaAccountMeta[], required: Account metadata for the instruction
          - `is_signer` boolean, required: Whether the account is a signer
          - `is_writable` boolean, required: Whether the account is writable
          - `pubkey` string, required: Account public key (base58-encoded)
        - `data` string, required: Instruction data (base64-encoded)
        - `program_id` string, required: Program ID (base58-encoded pubkey)
      - `sent_at` string
      - `signature` string
      - `status` 'canceled' | 'pending' | 'sent' | 'submitted' | 'mined' | 'confirmed' | 'failed' | 'expired', required
      - `status_reason` string
      - `transaction` string, required
    - StellarTransactionResponse
      - `confirmed_at` string
      - `created_at` string, required
      - `fee` integer, required
      - `hash` string
      - `id` string, required
      - `relayer_id` string, required
      - `sent_at` string
      - `sequence_number` string, required: Stellar sequence number encoded as a decimal string to preserve precision.
      - `source_account` string, required
      - `status` 'canceled' | 'pending' | 'sent' | 'submitted' | 'mined' | 'confirmed' | 'failed' | 'expired', required
      - `status_reason` string, nullable
      - `transaction_result_xdr` string
  - `error` string
  - `metadata` PluginMetadata
    - `logs` LogEntry[], nullable
      - `level` 'log' | 'info' | 'error' | 'warn' | 'debug' | 'result', required
      - `message` string, required
    - `traces` unknown[], nullable
      - unknown
  - `pagination` PaginationMeta
    - `current_page` integer, required
    - `per_page` integer, required
    - `total_items` integer, required
  - `success` boolean, required

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal server error

## Changes

- **2026-10-12** `7d050531931d`: 1 info
  - added the optional property `data/oneOf[#/components/schemas/EvmTransactionResponse]/is_canceled` to the response with the `200` status
- **2026-06-05** `97fada1b2001`: 1 breaking, 1 info
  - the `data/oneOf[#/components/schemas/StellarTransactionResponse]/sequence_number` response's property type changed from `integer` to `string`, and format from `int64` to no format for status `200`
  - the `data/oneOf[#/components/schemas/StellarTransactionResponse]/sequence_number` response's property pattern `^-?[0-9]+$` was added for the status `200`
- **2025-12-22** `2abd60a9c2d8`: 1 info
  - added the optional property `data/oneOf[#/components/schemas/StellarTransactionResponse]/transaction_result_xdr` to the response with the `200` status
- **2025-11-07** `d1f71894e671`: 1 info
  - added the optional property `data/oneOf[#/components/schemas/SolanaTransactionResponse]/instructions` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/openzeppelin/apis/openzeppelin-relayer-api/changes/api/v1/relayers/:relayer_id/transactions/by-nonce/:nonce/get.md)

---

[API](https://skmtc.dev/openzeppelin/apis/openzeppelin-relayer-api.md) - [All operations](https://skmtc.dev/openzeppelin/apis/openzeppelin-relayer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openzeppelin/apis/openzeppelin-relayer-api/revisions/6b7732f94f53?raw)