List store products (Products v2; up to 50 per page).

Use to browse the catalog. Filter with modified_after / modified_before (ISO-8601 UTC, e.g. 2024-01-01T00:00:00Z), type (PHYSICAL | SERVICE | GIFT_CARD | DIGITAL), or query (free-text search). Page forward with cursor from the previous response's pagination.nextPageCursor — send cursor ALONE, it cannot be combined with the filters.

Retrieve product(s) by id (Products v2).

Accepts a single id, or a comma-separated list of up to 50 ids to fetch several at once. Use when you already know the id(s).

List inventory items (stock levels) across variants, 50 per page.

Use to audit stock. Page forward with cursor from the prior response.

Retrieve inventory for specific variants (up to 50 ids per call).

Use when you know exact variant ids and want their current stock.

List store orders (up to 50 per page, newest-modified first).

Filter with fulfillment_status (PENDING, FULFILLED, or CANCELED) and/or modified_after (ISO-8601 UTC). Page with cursor.

Retrieve a single order by its id, including line items and totals.

List financial transactions for orders and donations (50 per page).

Bound the window with modified_after / modified_before (ISO-8601 UTC) and page with cursor.

List customer profiles (contacts/customers), 50 per page.

Page forward with cursor from the prior response.

Retrieve a single customer profile by its id.

MUTATES THE LIVE STORE. Set a variant's stock to an exact quantity.

This overwrites the current stock level for variant_id with the given finite quantity (a "set" operation, not a delta). Sent with an idempotency key. Returns the API result; a 204 is normalised to {}. Use only when you intend to change real inventory.

MUTATES THE LIVE STORE. Mark an order fulfilled with shipment details.

shipments is a list of shipment objects, each accepting carrierName, service, shipDate (ISO-8601), trackingNumber, and trackingUrl. When should_send_notification is true (default), Squarespace emails the customer. Use only when actually shipping an order.