Metadata

Get Catalog Metadata

• GET /$metadata: Returns the Catalog metadata as a JSON Schema document describing every resource (Category, Attribute Set, Product, Variant, Point of Sale) and the relationships between them. Use it to build requests against the rest of the API.

Authentication

Requires a valid API key in the X-API-KEY header.

Response

200 OK — A JSON schema document describing every resource in the Catalog (Category, Attribute Set, Product, Variant, Point of Sale) and the relationships between them. Use this document to build requests against the rest of the API.

Error Responses

• 401 Unauthorized — Missing or invalid API key.
• 404 Not Found — Tenant or model not found.
• 500 Internal Server Error — Unexpected technical error.

Example

Request:

GET /$metadata HTTP/1.1
X-API-KEY: your-api-key-here

Response:

HTTP/1.1 200 OK
Content-Type: application/json