---
title: "List published requests across integrators"
method: GET
path: "/published-requests"
---

# List published requests across integrators

`GET /published-requests`

## Request

- Base URL: `https://api.relay.link`
- URL: `https://api.relay.link/published-requests`
- Auth: none declared
- TypeScript: <https://skmtc.dev/relay/apis/cross-chain-solver/docs/published-requests/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the public subset of requests/v3 for terminal requests at least one minute old. Requires a valid API key; private chains require an explicit grant. Private fields and filters are unavailable.

## Query parameters

- `term` string
- `id` string
- `orderId` string
- `depositTxHash` string
- `fillTxHash` string
- `refundTxHash` string
- `user` string
- `recipient` string
- `originChainId` number
- `destinationChainId` number
- `status` 'success' | 'failure' | 'refund' | 'pending' | 'depositing'
- `currencyInChainId` number
- `currencyOutChainId` number
- `currencyInAddress` string
- `currencyOutAddress` string
- `currencyInSymbol` string
- `currencyOutSymbol` string
- `chainId` number
- `privateChainsToInclude` string
- `startTimestamp` number
- `endTimestamp` number
- `startBlock` number
- `endBlock` number
- `filters` string
- `sortBy` 'createdAt' | 'updatedAt'
- `sortDirection` 'asc' | 'desc'
- `includeTotal` boolean
- `limit` number
- `continuation` string

## Headers

- `x-api-key` string

## Response `200`

Default Response

- object
  - `requests` object[], required
    - `id` string
    - `status` 'success' | 'failure' | 'refund'
    - `user` string
    - `recipient` string, nullable
    - `sender` string, nullable
    - `createdAt` string
    - `updatedAt` string
    - `data` object
      - `inTxs` object[]
        - `txHash` string
        - `fee` string
        - `block` number
        - `type` string
        - `chainId` number
        - `timestamp` number
        - `status` 'success' | 'failure'
        - `data` object, nullable
          - `from` string
          - `to` string
          - `data` string
          - `value` string
        - `stateChanges` object[]
          - `address` string
          - `change` object
            - `kind` string
            - `balanceDiff` string
            - `data` object
              - …
      - `outTxs` object[]
        - `txHash` string
        - `fee` string
        - `block` number
        - `type` string
        - `chainId` number
        - `timestamp` number
        - `status` 'success' | 'failure'
        - `data` object, nullable
          - `from` string
          - `to` string
          - `data` string
          - `value` string
        - `stateChanges` object[]
          - `address` string
          - `change` object
            - `kind` string
            - `balanceDiff` string
            - `data` object
              - …
      - `route` object, nullable
        - `actual` object, nullable
          - `origin` object, nullable
            - `inputCurrency` object, nullable
              - …
            - `outputCurrency` object, nullable
              - …
          - `destination` object, nullable
            - `inputCurrency` object, nullable
              - …
            - `outputCurrency` object, nullable
              - …
    - `protocol` object, nullable
      - `orderId` string
      - `solver` object
        - `address` string
      - `deposit` object
        - `origin` object, nullable
          - `amount` string
          - `chainId` number
          - `currency` string
          - `depositor` string
          - `depository` string
          - `onchainId` string
          - `transactionId` string
      - `settlement` object
        - `destination` object
          - `fills` object[]
            - `chainId` number
            - `transactionId` string
          - `refunds` object[]
            - `chainId` number
            - `transactionId` string
  - `continuation` string
  - `total` number

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `429`: Default Response
- `500`: Default Response

## Changes

- **2026-11-02** `18f37f8bb945`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/relay/apis/cross-chain-solver/changes/published-requests/get.md)

---

[API](https://skmtc.dev/relay/apis/cross-chain-solver.md) - [All operations](https://skmtc.dev/relay/apis/cross-chain-solver/llms.txt) - [OpenAPI document](https://skmtc.dev/relay/apis/cross-chain-solver/revisions/ed331d1e4073?raw)