Hermeseus Docs
Legacy docs

Activity vouchers

Once an activity booking is issued, one or more vouchers become available. Fetch the list, then download each voucher to hand to the traveller.

List vouchers

GET/v3/HAPI/activities/bookings/{id}/vouchers

Requires the activities:read scope. Before the booking is issued the list is empty.

{
  "object": "activity_voucher_list",
  "booking_id": "abk_7Q2F9K",
  "data": [
    {
      "object": "activity_voucher",
      "id": "avc_1a2b3c",
      "visual_id": "BMG-7Q2F9K-1",
      "generated_at": "2026-08-27T10:20:00Z",
      "download_url": "https://api.hermeseus.com/v3/HAPI/activities/bookings/abk_7Q2F9K/vouchers/avc_1a2b3c/download"
    }
  ]
}

Download a voucher

GET/v3/HAPI/activities/bookings/{id}/vouchers/{voucher_id}/download

Requires activities:read. Streams the voucher as a PDF (Content-Type: application/pdf). Save the bytes or hand the file to the traveller.

Vouchers appear after issuance. A held or confirmed booking has no voucher yet. Poll the booking until it is issued, then the voucher list is populated.