curl -X GET 'https://<tenant>.product-management.flowkiwi.net/rest/api/metaobjects/{type}/{handle}' \ -H 'Authorization: Bearer {token}' \ -H 'X-Flowkiwi-Organization-Id: <org_id>' \ -H 'Accept: application/ld+json'

{ "@context": "/contexts/Metaobject", "@id": "/rest/api/metaobjects/019afc10-4d5e-7f60-9b71-3c4d5e6f7081", "@type": "Metaobject", "id": "019afc10-4d5e-7f60-9b71-3c4d5e6f7081", "definition": "/rest/api/metaobject_definitions/019afc01-1a2b-7c3d-8e4f-0a1b2c3d4e5f", "handle": "mens-shoes-eu", "status": "ACTIVE", "displayName": "EU men's shoes", "fields": [ { "key": "title", "value": "EU men's shoes", "type": "/rest/api/metafield_definition_types/single_line_text_field", "metaobject": [] }, { "key": "body", "value": "EU 40 = 25.5 cm, EU 41 = 26.2 cm, EU 42 = 27 cm", "type": "/rest/api/metafield_definition_types/multi_line_text_field", "metaobject": [] } ], "createdAt": "2026-01-15T09:30:00+00:00", "updatedAt": "2026-02-03T14:45:12+00:00" }

Retrieve a metaobject by handle

View as Markdown

get /rest/api/metaobjects/{type}/{handle}

Retrieves a Metaobject resource.

Returns a single metaobject by its definition type and its handle - the friendly slug lookup. Use this when you reference records by a stable, readable key rather than by id.

Headers

Name	Type	Required	Description
`X-Flowkiwi-Organization-Id`	`string`	required	The organization the request acts as. Determines the identity, permissions and ownership applied when reading or modifying data on the instance.

Path parameters

Name	Type	Required	Description
`type`	`string`	required	The metaobject definition type slug the metaobject belongs to.
`handle`	`string`	required	The metaobject's unique slug within its type.

Response

200 - Metaobject resource

Format

Property	Type	Required	Description
`@context`	`object`	-
`@id`	`string`	required
`@type`	`string`	required
`id`	`string`	-	The resource's unique identifier (UUID).
`definition`	`string`	-	The `MetaobjectDefinition` (IRI) this metaobject is a record of.
`handle`	`string`	-	The metaobject's unique slug within its definition type.
`status`	`"DRAFT" \| "ACTIVE"`	-	The publication status of the metaobject.
`displayName`	`string \| null`	-	The human-readable label, derived from the field named by the definition's displayNameField.

Property Type Required Description

id string - The resource's unique identifier (UUID).

definition string - The MetaobjectDefinition (IRI) this metaobject is a record of.

handle string - The metaobject's unique slug within its definition type.

status "DRAFT" | "ACTIVE" - The publication status of the metaobject.

displayName string | null - The human-readable label, derived from the field named by the definition's displayNameField.

fields EmbeddedMetaobjectFieldResource[] - The field values of the metaobject, one entry per field definition.

Show fields fields

Property Type Required Description

key string - The field key (matches a field definition key).

value string | null - The field value, stored as a string regardless of the field type.

type string - The field data type, as an IRI to the field-type resource.

metaobject Metaobject[] -

Show metaobject fields

Property	Type	Required	Description
`id`	`string`	-	The resource's unique identifier (UUID).
`definition`	`string`	-	The `MetaobjectDefinition` (IRI) this metaobject is a record of.
`handle`	`string`	-	The metaobject's unique slug within its definition type.
`status`	`"DRAFT" \| "ACTIVE"`	-	The publication status of the metaobject.
`displayName`	`string \| null`	-	The human-readable label, derived from the field named by the definition's displayNameField.
`fields`	`EmbeddedMetaobjectFieldResource[]`	-	The field values of the metaobject, one entry per field definition.
`createdAt`	`string`	-	The date and time when the resource was created (ISO 8601 format).
`updatedAt`	`string`	-	The date and time when the resource was last modified (ISO 8601 format).

createdAt string - The date and time when the resource was created (ISO 8601 format).

updatedAt string - The date and time when the resource was last modified (ISO 8601 format).

Errors

403 - Access denied. The caller is missing one or more identity permissions required for this operation.

Content-Type: application/problem+json

Property	Type	Required	Description
`@context`	`object`	-
`@id`	`string`	required
`@type`	`string`	required
`type`	`string`	-
`title`	`string`	-
`status`	`integer`	-
`detail`	`string`	-
`missingPermissions`	`string[]`	-	Identity permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied identity:* permission.

404 - Not found

Format

Property	Type	Required	Description
`@context`	`object`	-
`@id`	`string`	required
`@type`	`string`	required
`title`	`string \| null`	-	A short, human-readable summary of the problem.
`detail`	`string \| null`	-	A human-readable explanation specific to this occurrence of the problem.
`status`	`number \| null`	-
`instance`	`string \| null`	-	A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
`type`	`string`	-	A URI reference that identifies the problem type

Property	Type	Required	Description
`title`	`string \| null`	-	A short, human-readable summary of the problem.
`detail`	`string \| null`	-	A human-readable explanation specific to this occurrence of the problem.
`status`	`number \| null`	-
`instance`	`string \| null`	-	A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
`type`	`string`	-	A URI reference that identifies the problem type