Get Metafield by ID (Admin API only)

Get Metafield by ID

This endpoint is available on the Admin API (merchant JWT) only. It is not exposed to OAuth-scoped apps. Apps must use GET /api/v1/metafields.json with namespace + key (or ownerType + ownerId) filters instead.

Returns a single metafield by its UUID. Used by the merchant admin and by the admin’s resource detail editors.

Response

{
  "status": 200,
  "state": "success",
  "data": {
    "id": "e607f43e-9251-451e-a45c-38bf28d61154",
    "namespace": "custom",
    "key": "warranty_years",
    "value": 5,
    "raw_value": "5",
    "type": "number_integer",
    "owner_type": "product",
    "owner_id": "94995c07-e8a5-43f2-9d1a-18ccf8199adf",
    "app_id": null,
    "created_at": "2026-05-09T13:32:53.135Z",
    "updated_at": "2026-05-09T13:32:53.135Z"
  }
}

How apps should look up a single metafield

Use the list endpoint with exact filters — values are keyed by (owner type, namespace, key, owner), so there is at most one match:

curl -G "https://api.launchmystore.io/api/v1/metafields.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --data-urlencode "ownerType=product" \
  --data-urlencode "ownerId=<productId>" \
  --data-urlencode "namespace=custom" \
  --data-urlencode "key=warranty_years"

Returns at most one item under data.metafields[0].

Code	Description
`UNAUTHORIZED`	Invalid or missing JWT
`FORBIDDEN`	Wrong store / insufficient role
`NOT_FOUND`	Metafield does not exist or belongs to another store

Code

Description

UNAUTHORIZED

Invalid or missing JWT

FORBIDDEN

Wrong store / insufficient role

NOT_FOUND

Metafield does not exist or belongs to another store

Get Metafield by ID

Request

Auth

Path parameters

Response

How apps should look up a single metafield

Error codes

​Get Metafield by ID

​Request

​Auth

​Path parameters

​Response

​How apps should look up a single metafield

​Error codes

Get Metafield by ID

Request

Auth

Path parameters

Response

How apps should look up a single metafield

Error codes