---
title: "Sends a relay to the servicer to receive a response. The payload is the serialized form of one of the supported formats in a protobuf."
method: POST
path: "/v1/client/relay"
tags: ["client"]
---

# Sends a relay to the servicer to receive a response. The payload is the serialized form of one of the supported formats in a protobuf.

`POST /v1/client/relay`

## Request body

- RelayRequest
  - `payload` Payload, required
    - `id` string, byte
    - `jsonrpc` string, required
    - `method` string, required
    - `parameters` string, byte
    - `headers` Header[]
      - `name` string, required
      - `value` string, required
  - `meta` RelayRequestMeta, required
    - `block_height` integer, required
    - `servicer_pub_key` string, required
    - `chain` Identifiable, required
      - `id` string, required
      - `name` string, required
    - `geozone` Identifiable, required
      - `id` string, required
      - `name` string, required
    - `token` AAT, required
      - `version` string, required
      - `app_pub_key` string, required
      - `client_pub_key` string, required
      - `app_signature` string, required
    - `signature` string, required

## Response `200`

Relay request response

- RelayResponse
  - `payload` string, required
  - `servicer_signature` string, required

## Other responses

- `400` — Bad request
- `500` — An error occurred while sending the relay request to the network

## Changes

- **2023-06-29** (v1) `6201ade67438` — 1 breaking
  - the `payload/id` request property type/format changed from `string`/`` to `string`/`byte`
- **2023-06-20** (v1) `b2d6d478ea7b` — 1 breaking, 2 warning, 3 info
  - added the new required request property `payload/jsonrpc`
  - removed the request property `payload/data`
  - removed the request property `payload/path`
  - added the new optional request property `payload/id`
  - …2 more
- **2023-05-04** (v1) `ad9f656e884c` — 1 info
  - endpoint added
- **2022-11-03** (v1) `f1547121fa01` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pokt-network/apis/pocket-network/changes/v1/client/relay/post.md)

---

[API](https://skmtc.dev/pokt-network/apis/pocket-network.md) · [All operations](https://skmtc.dev/pokt-network/apis/pocket-network/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pokt-network/pocket-network/revisions/492a043fd702/schema)