Booking Discount Code Usages

Overview

This resource represents the usage of a Discount Code which are created when the Discount Code is applied via instant booking page or booknow widget.

Parameters

OAuth Scopes:

discount_code_usage_read

Name	Type	Read/Write	Description
id	String[UUID]	Read	Discount Code Usage's id.
currency	String	Read	Currency of applied discount.
amount_in_cents	Integer	Read	Applied amount of discount in cents.
created_at	Time	Read	Discount Code Usage create time (discount application time)
canceled_at	Time	Read	Discount Code Usage soft delete time

List Discount Code Usages

Returns all Discount Codes Usages for current account.

GET /booking/discount_code_usages

OAuth Scopes:

discount_code_usage_read

response.json

{
  "links": {
    "discount_codes.bookings": "http://www.bookingsync.com/api/v3/bookings/{discount_codes_usages.bookings}",
    "discount_codes.discount_codes": "http://www.bookingsync.com/api/v3/booking/discount_codes/{discount_code_usages.discount_code}"
  },
  "discount_codes": [
    {
      "links": {
        "booking": 42,
        "discount_code": 512
      },
      "id": "db6c0845-6122-4de6-a9ab-7a685e2a17f0",
      "currency": "EUR",
      "amount_in_cents": 10000,
      "created_at": "2025-03-31T17:52:09.552Z",
      "canceled_at": null
    }
  ],
  "meta": {}
}

Get a single Discount Code Usage

Returns a single Discount Code Usage identified by ID.

GET /booking/discount_code_usages/:discount_code_usage_id

OAuth Scopes:

discount_code_usage_read

response.json

{
  "links": {
    "discount_codes.bookings": "http://www.bookingsync.com/api/v3/bookings/{discount_codes_usages.bookings}",
    "discount_codes.discount_codes": "http://www.bookingsync.com/api/v3/booking/discount_codes/{discount_code_usages.discount_code}"
  },
  "discount_codes": [
    {
      "links": {
        "booking": 42,
        "discount_code": 512
      },
      "id": "db6c0845-6122-4de6-a9ab-7a685e2a17f0",
      "currency": "EUR",
      "amount_in_cents": 10000,
      "created_at": "2025-03-31T17:52:09.554Z",
      "canceled_at": null
    }
  ],
  "meta": {}
}