> ## Documentation Index > Fetch the complete documentation index at: https://docs.relay.link/llms.txt > Use this file to discover all available pages before exploring further. # Get Published Requests > Returns a public subset of cross-chain requests across integrators, limited to terminal requests that are at least one minute old. > [!NOTE] > > `GET /published-requests` requires a valid `x-api-key`. Short-lived session tokens are not accepted on this endpoint. Private-chain results are only returned when the API key has an explicit grant for those chains. ## OpenAPI ````yaml get /published-requests openapi: 3.0.3 info: title: Cross-chain solver version: 1.0.0 servers: - url: https://api.relay.link description: Mainnet API - url: https://api.testnets.relay.link description: Testnet API security: [] paths: /published-requests: get: summary: List published requests across integrators description: >- 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. parameters: - schema: type: string in: query name: term required: false - schema: type: string in: query name: id required: false - schema: type: string in: query name: orderId required: false - schema: type: string in: query name: depositTxHash required: false - schema: type: string in: query name: fillTxHash required: false - schema: type: string in: query name: refundTxHash required: false - schema: type: string in: query name: user required: false - schema: type: string in: query name: recipient required: false - schema: type: number in: query name: originChainId required: false - schema: type: number in: query name: destinationChainId required: false - schema: type: string enum: - success - failure - refund - pending - depositing in: query name: status required: false - schema: type: number in: query name: currencyInChainId required: false - schema: type: number in: query name: currencyOutChainId required: false - schema: type: string in: query name: currencyInAddress required: false - schema: type: string in: query name: currencyOutAddress required: false - schema: type: string in: query name: currencyInSymbol required: false - schema: type: string in: query name: currencyOutSymbol required: false - schema: type: number in: query name: chainId required: false - schema: type: string in: query name: privateChainsToInclude required: false - schema: type: number in: query name: startTimestamp required: false - schema: type: number in: query name: endTimestamp required: false - schema: type: number in: query name: startBlock required: false - schema: type: number in: query name: endBlock required: false - schema: type: string in: query name: filters required: false description: >- JSON array of OR groups. Fields within a group are ANDed. Supports not: prefixes, arrays, and null checks for public identity, status, chain, and currency filters. - schema: type: string enum: - createdAt - updatedAt default: createdAt in: query name: sortBy required: false - schema: type: string enum: - asc - desc default: desc in: query name: sortDirection required: false - schema: type: boolean default: false in: query name: includeTotal required: false - schema: type: number minimum: 1 maximum: 100 multipleOf: 1 default: 20 in: query name: limit required: false - schema: type: string in: query name: continuation required: false - schema: type: string in: header name: x-api-key required: false description: Required API key. responses: '200': description: Default Response content: application/json: schema: type: object additionalProperties: false properties: requests: type: array items: type: object additionalProperties: false properties: id: type: string status: type: string enum: - success - failure - refund user: type: string recipient: type: string nullable: true sender: type: string nullable: true createdAt: type: string updatedAt: type: string data: type: object additionalProperties: false properties: inTxs: type: array items: type: object additionalProperties: false properties: txHash: type: string fee: type: string block: type: number type: type: string chainId: type: number timestamp: type: number status: type: string enum: - success - failure data: type: object nullable: true additionalProperties: false properties: from: type: string to: type: string data: type: string value: type: string stateChanges: type: array items: type: object additionalProperties: false properties: address: type: string change: type: object additionalProperties: false properties: kind: type: string balanceDiff: type: string data: type: object additionalProperties: false properties: tokenAddress: type: string tokenKind: type: string tokenId: type: string outTxs: type: array items: type: object additionalProperties: false properties: txHash: type: string fee: type: string block: type: number type: type: string chainId: type: number timestamp: type: number status: type: string enum: - success - failure data: type: object nullable: true additionalProperties: false properties: from: type: string to: type: string data: type: string value: type: string stateChanges: type: array items: type: object additionalProperties: false properties: address: type: string change: type: object additionalProperties: false properties: kind: type: string balanceDiff: type: string data: type: object additionalProperties: false properties: tokenAddress: type: string tokenKind: type: string tokenId: type: string route: type: object nullable: true additionalProperties: false properties: actual: type: object nullable: true additionalProperties: false properties: origin: type: object nullable: true additionalProperties: false properties: inputCurrency: type: object nullable: true additionalProperties: false properties: currency: type: object additionalProperties: false properties: chainId: type: number address: type: string symbol: type: string name: type: string decimals: type: number amount: type: string amountFormatted: type: string outputCurrency: type: object nullable: true additionalProperties: false properties: currency: type: object additionalProperties: false properties: chainId: type: number address: type: string symbol: type: string name: type: string decimals: type: number amount: type: string amountFormatted: type: string destination: type: object nullable: true additionalProperties: false properties: inputCurrency: type: object nullable: true additionalProperties: false properties: currency: type: object additionalProperties: false properties: chainId: type: number address: type: string symbol: type: string name: type: string decimals: type: number amount: type: string amountFormatted: type: string outputCurrency: type: object nullable: true additionalProperties: false properties: currency: type: object additionalProperties: false properties: chainId: type: number address: type: string symbol: type: string name: type: string decimals: type: number amount: type: string amountFormatted: type: string protocol: type: object nullable: true additionalProperties: false properties: orderId: type: string solver: type: object additionalProperties: false properties: address: type: string deposit: type: object additionalProperties: false properties: origin: type: object nullable: true additionalProperties: false properties: amount: type: string chainId: type: number currency: type: string depositor: type: string depository: type: string onchainId: type: string transactionId: type: string settlement: type: object additionalProperties: false properties: destination: type: object additionalProperties: false properties: fills: type: array items: type: object additionalProperties: false properties: chainId: type: number transactionId: type: string refunds: type: array items: type: object additionalProperties: false properties: chainId: type: number transactionId: type: string continuation: type: string total: type: number required: - requests '400': description: Default Response content: application/json: schema: type: object properties: message: type: string errorCode: type: string errorData: {} requestId: type: string required: - message '401': description: Default Response content: application/json: schema: type: object properties: message: type: string errorCode: type: string errorData: {} requestId: type: string required: - message '404': description: Default Response content: application/json: schema: type: object properties: message: type: string errorCode: type: string errorData: {} requestId: type: string required: - message '429': description: Default Response content: application/json: schema: type: object properties: message: type: string errorCode: type: string errorData: {} requestId: type: string required: - message '500': description: Default Response content: application/json: schema: type: object properties: message: type: string errorCode: type: string errorData: {} requestId: type: string required: - message ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.