Skip to main content

List voucher templates

Method GET​

https://my.easyweek.io/api/public/v2/voucher-templates

Description: This endpoint returns the workspace's voucher templates, paginated. A voucher template is the sellable definition (title, price/value, and what it applies to); issued vouchers are a separate concept. cost is the customer-facing purchase price.

Example Request​

curl -i -X GET \
  https://my.easyweek.io/api/public/v2/voucher-templates?per_page={per_page} \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Query Parameters​

  • per_page (integer, optional): Number of items per page (alias of limit), maximum 100. Defaults to 15.

Example Response​

{
  "data": [
    {
      "uuid": "d3f1c2b4-6a7e-4b1c-9d0e-1f2a3b4c5d6e",
      "title": "Gift 100",
      "description": null,
      "notes": null,
      "primary_color": "blue",
      "is_single_charge": false,
      "cost": 9000,
      "value": 10000,
      "is_connected_all_branches": true,
      "all_branches_count": 3,
      "branches_count": 3,
      "is_connected_all_services": true,
      "all_services_count": 12,
      "services_count": 12,
      "is_connected_all_goods": false,
      "all_goods_count": 5,
      "goods_count": 0,
      "vouchers_count": 0,
      "activated_vouchers_count": 0,
      "validity": 12,
      "activate_at": null,
      "forces_activation": false,
      "activate_after": 0,
      "is_enabled": true,
      "has_limit_of_sales": true,
      "sales_limit": 100,
      "is_online": true,
      "is_shown_on_website": true,
      "is_shown_in_marketplace": true,
      "created_at": "2026-07-16T09:00:00+0000"
    }
  ],
  "links": {
    "first": "https://my.easyweek.io/api/public/v2/voucher-templates?page=1",
    "last": "https://my.easyweek.io/api/public/v2/voucher-templates?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://my.easyweek.io/api/public/v2/voucher-templates",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}