Metaobjects
The store’s storefront-visible metaobject definitions: the custom content types a theme reads before rendering one.
Authorization
clientKey The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.
In: header
Header Parameters
Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… 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/metaobject-definitions" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Metaobject definitions", "data": [ { "type": "lookbook", "name": "Lookbook", "display_field": "title", "has_pages": true, "fields": [ { "key": "title", "name": "Title", "type": "single_line_text" }, { "key": "season", "name": "Season", "type": "single_line_text" }, { "key": "story", "name": "Story", "type": "multi_line_text" } ] } ]}Active entries of one storefront-visible definition, ordered by display name. Anything else 404s.
Authorization
clientKey The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.
In: header
Path Parameters
The metaobject type handle, as listed by GET /store/metaobject-definitions (type). A type the store does not expose to the storefront answers 404.
Query Parameters
Keyset cursor: pass the previous page next_cursor. Walk while has_more is true; a stale, tampered, cross-list or filter-changed cursor answers 422 validation_failed with the failure on starting_after. Never combine with page.
Items per read (alias of per_page, clamps 1..50). page mode caps at page 50 (a deeper page answers 422 validation_failed on page); walk the cursor past that.
Header Parameters
Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… 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
application/json
application/json
curl -X GET "https://example.com/store/metaobjects/lookbook?limit=15" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Metaobjects retrieved", "data": [ { "p_id": 1301, "type": "lookbook", "handle": "winter-26", "display_name": "Winter ’26", "status": "active", "fields": { "title": "Winter ’26", "season": "Winter 2026", "story": "Dusty-rose layers for December travel." } }, { "p_id": 1302, "type": "lookbook", "handle": "party-season", "display_name": "Party Season", "status": "active", "fields": { "title": "Party Season", "season": "Party season", "story": "Statement prints for Saturday parties." } } ], "meta": { "definition": { "type": "lookbook", "name": "Lookbook", "has_pages": true } }, "has_more": false, "next_cursor": null}One storefront-visible metaobject entry by type and handle.
Authorization
clientKey The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.
In: header
Path Parameters
The metaobject type handle, as listed by GET /store/metaobject-definitions (type). A type the store does not expose to the storefront answers 404.
Handle of the entry, as returned for that type (handle). Only active entries are served.
Header Parameters
Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… 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
application/json
curl -X GET "https://example.com/store/metaobjects/lookbook/winter-26" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Metaobject entry", "data": { "p_id": 1301, "type": "lookbook", "handle": "winter-26", "display_name": "Winter ’26", "status": "active", "fields": { "title": "Winter ’26", "season": "Winter 2026", "story": "Dusty-rose layers for December travel." } }, "meta": { "definition": { "type": "lookbook", "name": "Lookbook", "has_pages": true } }}