GET /catalog/products/{product_id}/metafields

Returns a list of Product Metafields. Optional parameters can be passed in.

Servers

https://api.bigcommerce.com/stores/{store_hash}/v3

Path parameters

Name	Type	Required	Description
`product_id`	Integer	Yes	The ID of the `Product` to which the resource belongs.

Request headers

Name Type Required Description

Accept

String

Yes

The MIME type of the response body.

Default value: "application/json"

Query parameters

Name	Type	Required	Description
`exclude_fields[]`	Array	No	Fields to exclude, in a comma-separated list. The specified fields will be excluded from a response. The ID cannot be excluded.
`key:in[]`	Array	No	Filter based on comma-separated metafieldʼs keys. Could be used with vanilla `key` query parameter.
`date_created:max`	String	No	'Query parameter that lets you filter by the maximum date created, for example, `2024-05-14T09:34:00` or `2024-05-14`. Returns metafields created before this date.'
`include_fields[]`	Array	No	Fields to include, in a comma-separated list. The ID and the specified fields will be returned.
`date_modified:max`	String	No	'Query parameter that lets you filter by the maximum date modified created, for example, `2024-05-14T09:34:00` or `2024-05-14`. Returns metafields modified before this date.'
`before`	String	No	A cursor indicating where to start retrieving the previous page of results. Use this parameter to paginate backward. Not required for the initial request. For subsequent requests, use the end_cursor value returned in meta.cursor_pagination from the previous response. Works with limit, direction, and other supported query parameters. When specified, offset-based pagination (page) is ignored. Cannot be used in combination with the after parameter.
`page`	Integer	No	Specifies the page number in a limited (paginated) list of products.
`date_modified:min`	String	No	'Query parameter that lets you filter by the minimum date modified created, for example, `2024-05-14T09:34:00` or `2024-05-14`. Returns metafields modified after this date.'
`limit`	Integer	No	Controls the number of items per page in a limited (paginated) list of products. Default value: 50
`namespace`	String	No	Filter based on a metafieldʼs namespaces.
`namespace:in[]`	Array	No	Filter based on comma-separated metafieldʼs namespaces. Could be used with vanilla `namespace` query parameter.
`direction`	String	No	Sort direction. Acceptable values are: `asc`, `desc`. Valid values: `"desc"` `"asc"`
`key`	String	No	Filter based on a metafieldʼs key.
`after`	String	No	A cursor indicating where to start retrieving the next page of results. Use this parameter to paginate forward. Not required for the initial request. For subsequent requests, use the start_cursor value returned in meta.cursor_pagination from the previous response. Works with limit, direction, and other supported query parameters. When specified, offset-based pagination (page) is ignored. Cannot be used in combination with the before parameter.
`date_created:min`	String	No	'Query parameter that lets you filter by the minimum date created, ffor example, `2024-05-14T09:34:00` or `2024-05-14`. Returns metafields created after this date.'
`resource_id:in`	String	No	A comma-separated list of entity ID values that filter results to metafields that belong to one of the matching entities.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.