---
title: "Inspect a Synthetic Book definition"
method: GET
path: "/v1/synthetics/{synthetic_id}"
tags: ["Synthetic Books"]
---

# Inspect a Synthetic Book definition

`GET /v1/synthetics/{synthetic_id}`

## Request

- Base URL: `https://execution.kairos.trade`
- URL: `https://execution.kairos.trade/v1/synthetics/{synthetic_id}`
- Auth: API key in header `X-Client-Id` and API key in header `X-Api-Key` and API key in header `X-Api-Secret`

Returns materialization metadata only when the authenticated user owns an active lease for this canonical id. Cross-account subscriber counts are intentionally omitted.

## Path parameters

- `synthetic_id` string, required

## Response `200`

Current materialization metadata and canonical definition echo.

- object

## Other responses

- `400`: synthetic_id is not canonical.
- `401`: Missing or invalid account credentials.
- `404`: No active account-owned lease or unknown materialization.
- `429`: Synthetic Books request rate limit exceeded.
- `502`: Private materializer unavailable or returned an invalid response.
- `503`: Synthetic Books is not configured on this execution node.

---

[API](https://skmtc.dev/kairos/apis/kairos-order-execution-api.md) - [All operations](https://skmtc.dev/kairos/apis/kairos-order-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kairos/apis/kairos-order-execution-api/revisions/9ba7d463d505?raw)