---
title: "Get Workflow Status"
method: GET
path: "/workflows/getStatus"
---

# Get Workflow Status

`GET /workflows/getStatus`

Retrieves the status of a workflow transaction by transaction ID.

## Query parameters

- `txId` string, required

## Response `200`

Workflow status response

- WorkflowStatusResponse
  - `txId` string, required — Transaction ID
  - `status` 'success' | 'failed' | 'pending', required — Workflow status
  - `operation` string, required — Operation type
  - `timestamp` integer, required — Unix timestamp when workflow was executed
  - `name` string, required — Workflow name
  - `data` union, required — Workflow-specific data
    - PolyMarketWorkflowData
      - `userId` string, required — Polymarket user ID
      - `orderRequest` PolymarketOrderRequest, required
        - `side` 'BUY' | 'SELL', required — Order side
        - `tokenID` string, required — Polymarket CLOB token ID
        - `orderType` 'FOK' | 'FAK' | 'GTC' | 'GTD', required — Order type (FOK/FAK are market orders, GTC/GTD are limit orders)
        - `feeRateBps` number, required — Fee rate in basis points
        - `slippage` number, required — Slippage tolerance in basis points
        - `tickSize` '0.01' | '0.001' | '0.0001', required — Price tick size
        - `negRisk` boolean, required — Negative risk flag
        - `amount` number — Amount for market orders (FOK/FAK)
        - `price` number — Price per share (0-1) - required for limit orders, optional for market orders
        - `size` number — Number of shares for limit orders
      - `orderResponse` union, required — Order response from Polymarket
        - PolymarketOpenOrder
          - `id` string, required — Order ID
          - `status` string, required — Order status
          - `owner` string, required — Owner ID
          - `maker_address` string, required — Maker address
          - `market` string, required — Market ID
          - `asset_id` string, required — Asset ID (token ID)
          - `side` 'BUY' | 'SELL', required — Order side
          - `original_size` string, required — Original order size
          - `size_matched` string, required — Size matched
          - `price` string, required — Order price
          - `outcome` string, required — Order outcome
          - `expiration` string, required — Expiration timestamp
          - `order_type` string, required — Order type
          - `associate_trades` string[], required — Associated trade IDs
          - `created_at` integer, required — Unix timestamp when order was created
        - object
          - `error` string, required — Error message
          - `status` string, required — Order status
      - `relayTx` object, nullable — Relay transaction details (null if not applicable)
        - `txHash` string — Transaction hash of the relay transaction
        - `status` string — Status of the relay transaction
    - object

## Other responses

- `400` — Bad request due to missing or invalid parameters
- `404` — Workflow not found
- `500` — Internal server error

---

[API](https://skmtc.dev/swaps/apis/prediction-market-data-api.md) · [All operations](https://skmtc.dev/swaps/apis/prediction-market-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaps/prediction-market-data-api/revisions/03e917d60cb7/schema)