List Policies

Retrieve policies with optional filters.

Method

GET /v1/policies

Query Parameters

locale · string

Response locale (e.g., en)

kind · string

cancellation | terms | other

scope · string

generic | product

productId · uuid

Limit to a specific product

Headers

Authorization · string · required

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

cURL

curl "https://api.voyantcloud.com/v1/policies?locale=en&kind=terms&scope=generic" \
  -H "Authorization: Bearer YOUR_API_KEY"

200 OK

{
  "data": [
    {
      "id": "pol_123",
      "workspace_id": "ws_abc",
      "kind": "terms",
      "scope": "generic",
      "status": "active",
      "title": "Terms & Conditions",
      "slug": "terms",
      "description_html": "<p>...</p>",
      "billing_cancellation_policy_id": null,
      "product_id": null,
      "locale": "en",
      "created_at": "2025-01-01T10:00:00Z",
      "updated_at": "2025-01-01T10:00:00Z"
    }
  ]
}