---
title: "Get gasless orders"
method: GET
path: "/orders"
tags: ["Order"]
---

# Get gasless orders

`GET /orders`

Retrieve one or more gasless orders filtered, optionally filered by query param(s). The request must at minimum include one of the following parameters: `orderId`, `orderIds`, `orderStatus`, `swapper`, or `filler`.

## Query parameters

- `orderType` 'Dutch' | 'Dutch_V2' | 'Dutch_V1_V2' | 'Dutch_V3' | 'Limit' | 'Priority'
- `orderId` string — A unique ID for the order. Used to track the order's status.
- `orderIds` string
- `limit` number
- `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'unverified' | 'insufficient-funds'
- `swapper` string
- `sortKey` 'createdAt'
- `sort` string
- `filler` string
- `cursor` string

## Response `200`

The request orders matching the query parameters.

- GetOrdersResponse
  - `requestId` string, required — A unique ID for the request.
  - `orders` UniswapXOrder[], required
    - `type` 'DutchLimit' | 'Dutch' | 'Dutch_V2' | 'Dutch_V3' | 'Priority', required
    - `encodedOrder` string, required — An encoded copy of the order details which will be submitted to the filler network along with the signed permit.
    - `signature` string, required
    - `nonce` string, required — A unique nonce for this order.
    - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'unverified' | 'insufficient-funds', required
    - `orderId` string, required — A unique ID for the order. Used to track the order's status.
    - `chainId` 1 | 10 | 56 | 130 | 137 | 324 | 480 | 1868 | 8453 | 10143 | 42161 | 42220 | 43114 | 81457 | 7777777 | 1301 | 84532 | 11155111 | 143 | 196, required — The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://uniswap-docs.readme.io/reference/faqs).
    - `quoteId` string — A unique ID for the quote.
    - `swapper` string — The wallet address which will receive the token.
    - `txHash` string — The unique hash of the transaction.
    - `input` OrderInput
      - `token` string, required — The token which will be sent, specified by its token address. For a list of supported tokens, see the [FAQ](https://uniswap-docs.readme.io/reference/faqs).
      - `startAmount` string — The intended execution quantity of tokens resulting from this swap.
      - `endAmount` string — The worst case quantity of tokens resulting from this swap.
    - `outputs` OrderOutput[]
      - `token` string, required — The token which will be received, specified by its token address. For a list of supported tokens, see the [FAQ](https://uniswap-docs.readme.io/reference/faqs).
      - `startAmount` string — The intended execution quantity of tokens resulting from this swap.
      - `endAmount` string — The worst case quantity of tokens resulting from this swap.
      - `isFeeOutput` boolean
      - `recipient` string — The wallet address which will receive the token.
    - `settledAmounts` SettledAmount[]
      - `tokenOut` string — The token which will be received, specified by its token address. For a list of supported tokens, see the [FAQ](https://uniswap-docs.readme.io/reference/faqs).
      - `amountOut` string — The quantity of tokens denominated in the token's base units. (For example, for an ERC20 token one token is 1x10^18 base units. For one USDC token one token is 1x10^6 base units.) This value must be greater than 0.
      - `tokenIn` string — The token which will be sent, specified by its token address. For a list of supported tokens, see the [FAQ](https://uniswap-docs.readme.io/reference/faqs).
      - `amountIn` string — The quantity of tokens denominated in the token's base units. (For example, for an ERC20 token one token is 1x10^18 base units. For one USDC token one token is 1x10^6 base units.) This value must be greater than 0.
    - `cosignature` string
    - `cosignerData` CosignerData
      - `decayStartTime` number — The unix timestamp at which the order will be eligible to be filled by alternate fillers at a lower price. Noted that the fill amount will not be lower than the output `endAmount`.
      - `decayEndTime` number — The unix timestamp at which the order will no longer be eligible to be filled by alternate fillers.
      - `exclusiveFiller` string — The address of the filler who has priority to fill the order by the `decayStartTime`.
      - `inputOverride` string
      - `outputOverrides` string[]
  - `cursor` string

## Other responses

- `400` — RequestValidationError eg. Token allowance not valid or Insufficient Funds.
- `404` — Orders not found.
- `419` — Ratelimited
- `500` — Unexpected error
- `504` — Request duration limit reached.

---

[API](https://skmtc.net/uniswap/apis/token-trading.md) · [All operations](https://skmtc.net/uniswap/apis/token-trading/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uniswap/token-trading/revisions/55533f9bd1ab/schema)