Policies

Store policies are legal pages (privacy, returns, shipping, terms) that you display on your storefront. The list endpoint gives you titles and handles for navigation. The detail endpoint gives you the full content.

List policies

Returns all published policies for your store.

GET /v1/policies

Auth: Publishable or secret key

Response

{
  "data": [
    {
      "id": 1,
      "public_id": "01J9ABC...",
      "title": "Privacy Policy",
      "handle": "privacy-policy",
      "policy_type": "privacy",
      "published_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-07-15T10:30:00.000Z"
    },
    {
      "id": 2,
      "public_id": "01J9DEF...",
      "title": "Returns Policy",
      "handle": "returns-policy",
      "policy_type": "returns",
      "published_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-06-20T14:00:00.000Z"
    }
  ]
}

Policy list fields

Field	Type	Description
`id`	integer	Policy ID
`public_id`	string	Public UUID
`title`	string	Policy title
`handle`	string	URL-safe slug
`policy_type`	string	One of `privacy`, `returns`, `shipping`, `terms`, `custom`
`published_at`	string	Publish date (ISO 8601)
`updated_at`	string	Last update date

Get a policy

Returns a single policy with its full content.

GET /v1/policies/{handle}

Auth: Publishable or secret key

Path parameters

Parameter	Type	Description
`handle`	string	Policy handle (URL slug)

Response

{
  "data": {
    "id": 1,
    "public_id": "01J9ABC...",
    "title": "Privacy Policy",
    "handle": "privacy-policy",
    "policy_type": "privacy",
    "blocks": {
      "sections": [
        { "type": "heading", "content": "What data we collect" },
        { "type": "paragraph", "content": "We collect your name, email..." }
      ]
    },
    "seo_title": "Privacy Policy | My Store",
    "seo_description": "How we handle your personal data.",
    "published_at": "2026-01-01T00:00:00.000Z",
    "created_at": "2025-12-15T10:00:00.000Z",
    "updated_at": "2026-07-15T10:30:00.000Z"
  }
}

Policy detail fields

Field	Type	Description
`id`	integer	Policy ID
`public_id`	string	Public UUID
`title`	string	Policy title
`handle`	string	URL-safe slug
`policy_type`	string	Policy type
`blocks`	object or null	Rich content (block editor format)
`seo_title`	string or null	SEO page title
`seo_description`	string or null	SEO meta description
`published_at`	string	Publish date
`created_at`	string	Creation date
`updated_at`	string	Last update date

Errors

Status	Code	Description
404	`not_found`	No policy with this handle exists

Examples

List all policies:

curl https://api.quantm7.com/v1/policies \
  -H "Authorization: Bearer q7_pk_your_key"

Get privacy policy:

curl https://api.quantm7.com/v1/policies/privacy-policy \
  -H "Authorization: Bearer q7_pk_your_key"

On this page