---
title: "Field semantics for agents"
method: GET
path: "/v1/schema"
tags: ["Meta"]
---

# Field semantics for agents

`GET /v1/schema`

## Request

- Base URL: `https://api.placementapi.com`
- URL: `https://api.placementapi.com/v1/schema`
- Auth: HTTP bearer

Hand-authored, machine-readable description of what the fields MEAN (inventory modes, verification, pricing, anchor distribution, rate limits), for a model-driven client to self-configure against. Not a type schema; this document is.

## Response `200`

OK

- object
  - `version` string
  - `description` string
  - `critical_semantics` object
  - `mcp` object
  - `endpoints` object
  - `placement_types` string[]

## Other responses

- `401`: Missing, malformed or revoked Bearer credential: `{ error: "unauthorized" }`.

---

[API](https://skmtc.dev/placementapi/apis/placement-api.md) · [All operations](https://skmtc.dev/placementapi/apis/placement-api/llms.txt) · [OpenAPI document](https://skmtc.dev/placementapi/apis/placement-api/revisions/fc4e7866eaf7?raw)