Skip to main content

List vouchers

GET 

https://api.tickettailor.com/v1/vouchers

Returns a list of paginated vouchers

Request

Query Parameters

    limit string

    The number of items to retrieve

    expiry_date integer

    Unix timestamp filter that returns items with matched expiry_date value.

    expiry_date.gt integer

    Unix timestamp filter that returns items with expiry_date greater than the given value.

    expiry_date.gte integer

    Unix timestamp filter that returns items with expiry_date greater than or equal to the given value.

    expiry_date.lt integer

    Unix timestamp filter that returns items with expiry_date less than given value.

    expiry_date.lte integer

    Unix timestamp filter that returns items with expiry_date less than or equal given value.

    created_at integer

    Unix timestamp filter that returns items with matched created_at value.

    created_at.gt integer

    Unix timestamp filter that returns items with created_at greater than given value.

    created_at.gte integer

    Unix timestamp filter that returns items with created_at greater than or equal given value.

    created_at.lt integer

    Unix timestamp filter that returns items with created_at less than given value.

    created_at.lte integer

    Unix timestamp filter that returns items with created_at less than or equal given value.

Responses

Successfully returned the list of vouchers

Schema
    data object[]
  • Array [
  • objectstring
    idstring

    A unique identifier for the voucher

    available_codesinteger

    The number of unused voucher codes belonging to the voucher

    event_series_idsstring[]

    List of event series IDs

    expiry objectnullable

    Voucher's expiry date

    datestring

    ISO-8601 date for the start of the event

    formattedstring

    A formatted date string for the start of the event

    isostring

    ISO-8601 date and time for the start of the event

    timestring

    Time for the start of the event

    timezonestring

    Timezone offset for the start of the event

    unixinteger

    Unix timestamp for the start of the event

    namestring

    A descriptive name given to the voucher

    partial_redemptionstring

    Indicates whether voucher can be partially redeemed

    Possible values: [true, false]

    total_codesinteger

    Total number of voucher codes belonging to the voucher

    typestring

    Type of voucher

    Possible values: [PROMO, GIFT_CARD]

    valueinteger

    The integer value in cents given to the voucher

  • ]
  • links object
    nextstringnullable
    previousstringnullable

Authorization: http

name: BasicAuthtype: httpdescription: Use base64 encoded api key created in Ticket Tailor dashboard.
scheme: basic
curl -L 'https://api.tickettailor.com/v1/vouchers' \
-H 'Accept: application/json' \
-H 'Authorization: Basic PHVzZXJuYW1lPjo8cGFzc3dvcmQ+'
Request Collapse all
Base URL
https://api.tickettailor.com
Auth
Parameters
— query
— query
— query
— query
— query
— query
— query
— query
— query
— query
— query