---
title: "GET /api/v1/projects/{project_id}/federation/relay"
method: GET
path: "/api/v1/projects/{project_id}/federation/relay"
---

# GET /api/v1/projects/{project_id}/federation/relay

`GET /api/v1/projects/{project_id}/federation/relay`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `project_id` integer, required

## Query parameters

- `stream` 'events' | 'receipts' | 'artifacts'
- `limit` integer
- `artifact_digest` string[]
- `epoch` integer

## Headers

- `Authorization` string

## Response `200`

OK

- RelayBatchResponse
  - `after` integer, required
  - `artifacts` EmbeddingArtifactResponse[]
    - `chunks` ChunkArtifactResponse[], required
      - `index` integer, required
      - `input_hash` string, required
      - `vector_bytes` string, byte, required
      - `vector_digest` string, required
    - `digest` string, required
    - `dimensions` integer, required
    - `encoding` string, required
    - `input_hash` string
    - `input_type` string, required
    - `issue_uid` string
    - `model` string, required
    - `model_revision` string
    - `normalization` string, required
    - `preprocessing` string, required
    - `producer_instance_uid` string
    - `project_uid` string
    - `provider` string, required
    - `recipe_fingerprint` string, required
    - `recipe_version` integer, required
    - `split_max_runes` integer, required
    - `split_overlap` integer, required
  - `envelopes` RelayEnvelopeResponse[], required
    - `authority_uid` string, required
    - `binding_uid` string, required
    - `body` string, byte, required
    - `digest` string, required
    - `epoch` integer, required
    - `path` string[], required
    - `project_uid` string, required
    - `receiver_instance_uid` string, required
    - `sender_instance_uid` string, required
    - `sequence` integer, required
    - `source_hash` string, required
    - `source_uid` string, required
    - `stream` string, required
    - `version` integer, required
  - `stream` string, required

## Other responses

- `default`: Error

## Changes

- **2026-10-14** `c5792dd95eca`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/federation/relay/get.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) - [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/351807923500?raw)