---
title: "List all Relays"
method: GET
path: "/relays"
tags: ["Core", "Relays"]
---

# List all Relays

`GET /relays`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/relays`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/relays/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all [Relays](/relay) for the App.

## Response `200`

The App's Relays have been fetched.

- object
  - `data` Relay[], required: An array of Relays belonging to the App.
    - `id` string, required: The unique identifier for the Relay.
    - `destinationDomain` string, required: The domain in front of which the Relay should be configured.
    - `evervaultDomain` string, required: The Evervault managed domain to which requests to be relayed to the destination domain should be sent.
    - `routes` RelayRoute[], required: A collection of route configurations for the Relay.
      - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'PATCH': The HTTP method that must be matched for the operation to be performed. For any method, use null.
      - `path` string, required: The path that must be matched for the operation to be performed. For wildcards, use '*'. For a catchall of all subsequent paths, use '**'.
      - `request` RelayAction[], required: The actions to be performed on the data on request.
        - `action` 'encrypt' | 'decrypt', required: The operation to perform on the selected data.
        - `selections` RelaySelection[], required: The selections of data on which the operation will be performed.
          - `type` 'header' | 'json' | 'form': The type of the selector used to identify the data on which the action should be performed.
          - `role` string: The role of the encrypted field that must be matched for the operation to be performed.
          - `selector` string, required: The selector that identifies the data on which the action should be performed
      - `response` RelayAction[], required: The actions to be performed on the data on response.
        - `action` 'encrypt' | 'decrypt', required: The operation to perform on the selected data.
        - `selections` RelaySelection[], required: The selections of data on which the operation will be performed.
          - `type` 'header' | 'json' | 'form': The type of the selector used to identify the data on which the action should be performed.
          - `role` string: The role of the encrypted field that must be matched for the operation to be performed.
          - `selector` string, required: The selector that identifies the data on which the action should be performed
    - `authentication` 'api-key' | 'null', nullable, required: The type of authentication required for the Relay
    - `encryptEmptyStrings` boolean, required: Whether or not empty strings should be encrypted.
    - `app` string, required: The unique identifier for the app to which the Relay belongs.
    - `createdAt` integer, required: The exact time, in epoch milliseconds, when this Relay was created.
    - `updatedAt` integer, required: The exact time, in epoch milliseconds, when this Relay was updated.

## Changes

- **2026-11-06** `8d0ca833fa04`: 10 info
  - the response property `data` became required for the status `200`
  - the response property `data/items/app` became required for the status `200`
  - the response property `data/items/authentication` became required for the status `200`
  - the response property `data/items/createdAt` became required for the status `200`
  - …6 more
- **2025-11-18** `30ea25af4354`: 1 breaking, 2 warning, 2 info
  - the response property `data/items/authentication` became nullable for the status `200`
  - added the new `api-key` enum value to the `data/items/authentication` response property for the response status `200`
  - added the new `undefined` enum value to the `data/items/authentication` response property for the response status `200`
  - api tag `Core` added
  - …1 more

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/relays/get.md)

---

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