Measura API documentation · v1

List products

Discover products and their Measura configuration before retrieving variant measurement settings.

Code example

GET /api/v1/products

Headers:
  Authorization: Bearer <api-key>

Query parameters

Scroll horizontally to see all columns.

Parameter	Type	Description
`limit`	integer	Optional. Positive integer; capped at 100. Default: 25. Controls the Shopify page size before measurement-type filtering.
`cursor`	string	Optional. Opaque nextCursor from a previous response; pagination is forward only.
`tag`	string	Optional. Filter Shopify products by tag.
`updatedSince`	string	Optional. ISO-8601 date/time; includes Shopify products updated at or after this time.
`measurementType`	string	Optional. Case-insensitive measurement type filter, such as weight, length, area, volume, or time. Applied after fetching each Shopify page.

Response example (200 success)

Code example

{
  "success": true,
  "data": {
    "products": [
      {
        "id": "123",
        "title": "Bulk flour",
        "handle": "bulk-flour",
        "tags": ["bulk"],
        "status": "ACTIVE",
        "createdAt": "2026-01-01T00:00:00Z",
        "updatedAt": "2026-10-19T00:00:00Z",
        "measurementType": "weight",
        "isSellByMeasurementConfigured": true
      }
    ]
  },
  "error": null,
  "meta": {
    "nextCursor": "opaque-page-end-cursor",
    "prevCursor": "opaque-page-start-cursor",
    "hasMore": true
  }
}

Response fields

Scroll horizontally to see all columns.

Field	Type	Description
`data.products`	array	Product summaries; includes unconfigured Shopify products unless filtered out by measurementType.
`data.products[].id`	string \| null	Shopify legacy numeric product ID.
`data.products[].title / handle / status`	string \| null	Shopify product title, URL handle, and status.
`data.products[].tags`	string[]	Shopify product tags.
`data.products[].createdAt / updatedAt`	string \| null	Shopify product creation and update timestamps.
`data.products[].measurementType`	string	Measurement type resolved from Measura settings. This value alone does not establish configuration or variant eligibility.
`data.products[].isSellByMeasurementConfigured`	boolean	Whether the product belongs to a configured Measura product group. Check individual variant eligibility separately.
`meta`	PaginationMeta	Pagination of the underlying Shopify page.
`error`	null	Null for a successful response.

Error responses

Scroll horizontally to see all columns.

Status code	Description
400	Invalid limit or updatedSince.
401 / 403 / 429	Authentication, Public API entitlement, or rate-limit failure.
500	Failed to fetch products.

Note

Responses are cached for five minutes and return Cache-Control: private, max-age=300.
The measurementType filter can produce an empty or short page even when meta.hasMore is true. Continue with nextCursor until hasMore is false.
nextCursor and prevCursor represent the fetched page's end and start. Use hasMore to decide whether to continue; a non-null nextCursor alone does not mean another page exists. Save prior request cursors locally for backward navigation.
updatedSince filters Shopify product update timestamps. It is not a change feed for all Measura settings or fractional inventory changes.

Retrieve measurement configuration using Get product with variants. See the Product object for the summary and detail shapes.