Skip to content

Get a metaobject entry

GET
/public/stores/{storeRef}/metaobjects/{type}/{handle}
curl --request GET \
--url https://apibase.ecomweb.app/api/v1/public/stores/example/metaobjects/example/example \
--header 'x-storefront-api-key: <x-storefront-api-key>'

Returns one active entry by its handle, with reference fields resolved to the referenced resource’s public data. A type that does not exist or is hidden, and an entry that does not exist or is a draft, answer 404. With a signed-in customer’s token, types the merchant opened to customers are readable too.

type
required
string

The metaobject type handle.

handle
required
string

The entry’s handle.

storeRef
required
string

The store’s ref, as returned by GET /stores.

Media typeapplication/json
object
fields
required

The field values, keyed by field key. Reference fields are resolved to the referenced resource’s public data.

object
key
additional properties
object
value
required

The value in the form its type defines. A reference type resolves to the referenced resource’s public data.

nullable
One of:
string
type
required

The metafield’s type, such as single_line_text_field or list.number_integer.

string
type
required

The type handle of the entry’s definition.

string
handle
required

The entry’s handle, unique within its type.

string
display_name
required

The text that names the entry: the display-name field’s value, or the handle.

string
updated_at
required

When the entry was last updated, as an ISO 8601 timestamp.

string

Example generated

{
"fields": {
"additionalProperty": {
"value": {},
"type": "example"
}
},
"type": "example",
"handle": "example",
"display_name": "example",
"updated_at": "example"
}

The key is missing, invalid, revoked or expired.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

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.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

Example generated

{
"statusCode": 1,
"message": [
"example"
],
"error": "example"
}

The resource does not exist in this store.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

Example generated

{
"statusCode": 1,
"message": [
"example"
],
"error": "example"
}