---
title: "GET /v2/relay/requests"
method: GET
path: "/v2/relay/requests"
tags: ["Relay"]
---

# GET /v2/relay/requests

`GET /v2/relay/requests`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/relay/requests`
- Auth: HTTP bearer

Read the caller's Relay requests, newest first, from Relay's /requests/v3 with Curator's key. `user` must be one of the caller's linked EVM wallets or their embedded Solana wallet; Relay is asked for requests where it is the sender or the recipient, so deposits into the wallet are included. Relay's own request objects and continuation come back unchanged, keeping only requests whose user or recipient is one of the caller's wallets. With `id`, a request that is not the caller's is 404.

## Query parameters

- `user` string, required: One of the caller's linked EVM wallets or their embedded Solana wallet
- `id` string
- `continuation` string
- `limit` integer

## Response `200`

One page of Relay requests

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `requests` object[], required
      - `user` string, nullable
      - `recipient` string, nullable
    - `continuation` string, nullable
  - `statusCode` number, required
  - `errorCode` string

## Other responses

- `400`: Invalid query, or Relay rejected the read (relay_requests_request_rejected)
- `401`: Missing or invalid Privy bearer token
- `403`: The wallet is not one of the caller's (relay_requests_wallet_not_linked)
- `404`: No request with this id is the caller's (relay_requests_not_found)
- `429`: Rate limited here or at Relay (relay_requests_rate_limited), with Retry-After when known
- `502`: Relay upstream failure (relay_requests_upstream_unavailable)
- `503`: Relay API key not configured, Privy user lookup or rate limiter unavailable
- `504`: Relay upstream timeout (relay_requests_timeout)

## Changes

- **2026-10-05** `0954abd75f80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/relay/requests/get.md)

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) - [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peer/apis/swagger-api/revisions/ef91955315e2?raw)