home > support > API > Marketplace API > Get tour promotions

Get tour promotions

List of tour promotions for agents only. This endpoint will show the promotions available for a specific tour and channel to an agent. It will only show promotions as long as the channel configuration allows it

REST info

Endpoint	/api/tours/promotions/get
Formats	XML
Example	/api/tours/promotions/get.xml
Verb	GET

PHP examples use the PHP Client Library with SimpleXML

Description

Currently it is not implemented in the PHP Client Library.

Parameters

$tour_id

Integer ID number of the tour to get promotions for.

$channel_id

Integer ID number for the channel this tour belongs to.

Example

// Query the TourCMS API
$result = $tourcms->request('/api/tours/promotions/get.xml?tour_id='.$tourId, $channelId);

// Loop through each promotion returned
foreach($result->promotions as $promotion) {
	// Print out the promotion name
	print $promotion->name.'
';
}

Example promotion
Promotion with 10 %
Soon-to-be-expired

Looking for sample code in a different language? TourCMS and community provided API libraries

Implementing yourself? Check the REST info for this endpoint.

Try it

Enter your TourCMS API credentials below to call this endpoint.

Marketplace Agent ID *

API Key *

Channel ID *

Tour Id *

Remember my API credentials

Querystring parameters

Querystring parameters
Parameter	Notes
tour_id	Tour whose promotions you want to retrieve.

Response fields

XML Node

Notes

request

Confirmation of the request that you sent

error

Any error message returned, if there is no error this will just contain the text OK

promotions

There will be one promotion node for promotion returned

Each promotion node contains the following child nodes.

XML Node

Notes

aid

Account Id

tour_id

Tour ID

promotion_id

Promotion ID

name

Promotion name

start_date

Initial date of the period of availability

end_date

Final date of the period of availability

type

It can be one of these 3 types

standard
early_bird
last_minute

discount

Percentage discount. It can go from 0 to 100

vacancies

Number of maximum vacancies allowed to use the promotion

notice_period_days

Notice period in days

tour_departure_structure

Tour departure structure which the promotion applies to

XML Node

Notes

type

It can be:

SINGLE
START_TIME
DEPARTURE_CODE
SUPPLIER_NOTE
SUPPLIER_NOTE_PLUS_START_TIME

departure_types

This node is present if the type is different from SINGLE since there can be different values for the rest of the types

XML Node

Notes

value

Value of the departure type

partial

Shows whether the partial mapping goes at the beggining or at the end of the departure type. It only appears if the type is SUPPLIER_NOTE_PLUS_START_TIME

start_times

This node appears if the type is SUPPLIER_NOTE_PLUS_START_TIME and contains the start times associated to the supplier note

XML Node	Notes
start_time	Start time associated to the supplier note

Example response

 <?xml version="1.0"?>
<response>
<request>GET /api/tours/promotions/get.xml?tour_id=262</request>
<error>OK</error>
<promotions>
    <promotion>
        <aid>1</aid>
        <tour_id>262</tour_id>
        <promotion_id>10</promotion_id>
        <name>ejemplo</name>
        <start_date>2026-01-14</start_date>
        <end_date>2026-01-15</end_date>
        <type>standard</type>
        <discount>20</discount>
        <vacancies>50</vacancies>
        <notice_period_days>0</notice_period_days>
        <tour_departure_structure>
            <type>SINGLE</type>
        </tour_departure_structure>
    </promotion>
</promotions></response>

More information

Back to API list

Contact Info

Learn More

Follow Us

Get tour promotions

REST info

Code samples

Description

Parameters

Example

Try it

Querystring parameters

Response fields

Example response

More information