List metaobject entries
const url = 'https://apibase.ecomweb.app/api/v1/public/stores/example/metaobjects/example';const options = {method: 'GET', headers: {'x-storefront-api-key': '<x-storefront-api-key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://apibase.ecomweb.app/api/v1/public/stores/example/metaobjects/example \ --header 'x-storefront-api-key: <x-storefront-api-key>'Returns a page of the active entries of a metaobject type, in ascending ID order. Only types the merchant made visible to the storefront are readable; a type that does not exist or is hidden answers 404. With a signed-in customer’s token, types the merchant opened to customers are readable too. Page with cursor and limit (20 by default, at most 50), and narrow with filter[key]=value on the type’s filter keys.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The metaobject type handle.
The store’s ref, as returned by GET /stores.
Query Parameters
Section titled “Query Parameters”The next_cursor of the previous page; omit for the first page.
Number of entries per page, 20 by default and at most 50.
Responses
Section titled “Responses”object
The entries on this page, in ascending ID order.
object
The field values, keyed by field key. Reference fields are resolved to the referenced resource’s public data.
object
object
The metafield’s type, such as single_line_text_field or list.number_integer.
The type handle of the entry’s definition.
The entry’s handle, unique within its type.
The text that names the entry: the display-name field’s value, or the handle.
When the entry was last updated, as an ISO 8601 timestamp.
Pass as the cursor query parameter to get the next page, or null on the last page.
Example generated
{ "items": [ { "fields": { "additionalProperty": { "value": {}, "type": "example" } }, "type": "example", "handle": "example", "display_name": "example", "updated_at": "example" } ], "next_cursor": "example"}The request is malformed or failed validation.
object
The HTTP status code.
What went wrong; validation failures list one message per problem.
The HTTP status text, such as Bad Request.
object
A stable, machine-readable error code.
A human-readable explanation.
Extra context about the error, when there is any.
object
When the error happened, as an ISO 8601 timestamp.
Example generated
{ "statusCode": 1, "message": [ "example" ], "error": "example"}The key is missing, invalid, revoked or expired.
object
The HTTP status code.
What went wrong; validation failures list one message per problem.
The HTTP status text, such as Bad Request.
object
A stable, machine-readable error code.
A human-readable explanation.
Extra context about the error, when there is any.
object
When the error happened, as an ISO 8601 timestamp.
Example generated
{ "statusCode": 1, "message": [ "example" ], "error": "example"}The key may not do this: a missing scope, a readonly key, a publishable key on a Store API route, or a disallowed origin.
object
The HTTP status code.
What went wrong; validation failures list one message per problem.
The HTTP status text, such as Bad Request.
object
A stable, machine-readable error code.
A human-readable explanation.
Extra context about the error, when there is any.
object
When the error happened, as an ISO 8601 timestamp.
Example generated
{ "statusCode": 1, "message": [ "example" ], "error": "example"}The resource does not exist in this store.
object
The HTTP status code.
What went wrong; validation failures list one message per problem.
The HTTP status text, such as Bad Request.
object
A stable, machine-readable error code.
A human-readable explanation.
Extra context about the error, when there is any.
object
When the error happened, as an ISO 8601 timestamp.
Example generated
{ "statusCode": 1, "message": [ "example" ], "error": "example"}