Count metafield by definition

GET 
/openapi/2025-06/metafield_definition/:owner_resource/count

Retrieve the count of metafields by definition IDs.

Request

Path Parameters

owner_resource stringrequired
Resource type the metafield definitions are attached to:
• shop: Shop
• product: Product
• product_image: Product image
• product_variant: Product variant
• order: Order
• page: Custom page
• customer: Customer
• collection: Collection
• blog: Blog
• article: Article
• app: App

Query Parameters

definition_ids uint64[]

Array of metafield definition IDs to count. Example: ?definition_ids=1001&definition_ids=1002

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object
items object[]
Number of metafields grouped by metafield definition ID
Array [
metafield_countint32
Number of metafields associated with this definition
definition_iduint64
The metafield definition ID
]

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "metafield_count": 0,
        "definition_id": 0
      }
    ]
  }
}