get https://{shopdomain}.myshoplaza.com/openapi/2022-01///metafields/
Retrieves the details of a specific metafield for a resource.
This API is especially useful for:
- Fetching custom metadata associated with a specific resource (e.g., product, order).
- Viewing details of metafield configuration and values for analysis or debugging.
- Extending resource data retrieval for external integrations.
Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all queries are applied to the correct store.
Request Parameters
Public Request Parameters
Path Parameters
| Field | Type | Required | Example | Description |
|---|---|---|---|---|
resource | string | Yes | product | The type of resource the metafield is attached to. Available values: shop, product, product_image, product_variant, order, page, customer, collection, blog, article. |
resource_id | string | Yes | 1234567890 | The unique ID of the resource to which the metafield is attached. |
id | string | Yes | 374087540346466346 | The unique ID of the metafield to retrieve. |
Response Explanation
Public Response Parameters
Successful Response
| Field | Type | Example | Description |
|---|---|---|---|
metafield | object | Metafield object containing all metafield details. | |
metafield.id | string | 374087540346466346 | Unique identifier for the metafield. |
metafield.store_id | integer | 633130 | Store ID associated with the metafield. |
metafield.created_at | string | 2024-04-28T06:52:36Z | Creation timestamp in UTC. |
metafield.updated_at | string | 2024-04-28T06:52:36Z | Last update timestamp in UTC. |
metafield.owner_resource | string | product | The resource type the metafield is attached to. |
metafield.owner_id | string | a1a88be0-a1d4-47e4-a2f2-ba6e131cf447 | ID of the resource to which the metafield is attached. |
metafield.namespace | string | shirt | Namespace to group the metafield. |
metafield.key | string | weight1 | Key to identify the metafield. |
metafield.type | string | weight | Type of data stored in the metafield. |
metafield.value | number | 10 | Value stored in the metafield. |
metafield.description | string | weight | Brief description of the metafield. |
metafield.definition_id | string | 374087760941687850 | ID of the metafield definition used. |
Error Response
Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.
| Field | Type | Example | Description |
|---|---|---|---|
errors | array | ["data not found"] | A list of errors encountered during the request processing. |
| Field | Type | Example | Description |
|---|---|---|---|
error | String | "store is not active" | Indicates an error encountered during the process |
Error Detail
| Status Code | Message | Possible Reason | Example Response |
|---|---|---|---|
| 400 | Bad Request | Invalid input format or request structure (e.g., missing required fields or incorrect data types). | Bad Request |
| Unauthorized | The request is missing valid authentication credentials or the credentials provided are invalid. | Unauthorized | |
| 404 | data not found | can not find data based on resource and resource id | data not found |