Metafield Definitions
The store’s metafield schema: what each metafields value on a product means, its type and allowed values. Values are already public on the product; this exposes only their shape, never a value, and never a definition belonging to another store.
Authorization
clientKey The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/metafield-definitions" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Metafield definitions", "data": [ { "p_id": 512, "handle": "custom.fabric", "owner_type": "product", "namespace": "custom", "key": "fabric", "type": "single_line_text", "storefront_visible": true, "pinned": true, "pinned_position": 1, "name": "Fabric", "description": "The fabric a piece is cut in: cotton, ankara, silk or linen.", "validations": { "choices": [ "cotton", "ankara", "silk", "linen" ] }, "created_at": "2026-02-10T10:00:00.000000Z", "updated_at": "2026-02-10T10:00:00.000000Z" }, { "p_id": 513, "handle": "custom.care", "owner_type": "product", "namespace": "custom", "key": "care", "type": "multi_line_text", "storefront_visible": true, "pinned": false, "pinned_position": null, "name": "Care instructions", "description": "How to wash and keep the piece.", "validations": [], "created_at": "2026-02-10T10:05:00.000000Z", "updated_at": "2026-02-10T10:05:00.000000Z" } ]}