---
title: "POST /relay/status"
method: POST
path: "/relay/status"
tags: ["Relay"]
---

# POST /relay/status

`POST /relay/status`

## Request body

- RelayStatusRequest
  - `taskId` string, required

## Response `200`

Success

- RelayStatusResponse
  - `debug` RelayDebugResponse
    - `tenderlyUrl` string
    - `calldata` string
    - `errorData` string, nullable
    - `errorCode` string, nullable
    - `blockNumber` number, double, nullable
    - `account` string
    - `operationType` string
    - `to` string
    - `from` string, nullable
    - `chainId` number, double
  - `revertData` string — Raw revert bytes when the chain produced any — public on-chain data the client can decode.
  - `reason` string — Failure detail when the relay has one; absent while the operation is in flight.
  - `txHash` string
  - `status` 'pending' | 'executed' | 'reverted' | 'failed' | 'unknown', required — Lifecycle of a relay operation as reported by GMX Relay.
  - `taskId` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `503` — Relay Unavailable

## Changes

- **2026-08-25** `4455f6c22f99` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/changes/relay/status/post.md)

---

[API](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api.md) · [All operations](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gmx/gmx-io-gmx-public-api/revisions/4455f6c22f99/schema)