Een REST API en webhooks om je eigen software te koppelen aan het PMS en de channelmanager van MyTourist. Open docs, JSON overal en een token per bedrijfsprofiel.
$ curl -G https://app.mytourist.cloud/api/v1/availability \
-H "Authorization: Bearer $MYTOURIST_TOKEN" \
-d arrival=2030-07-01 \
-d departure=2030-07-04
[
{
"id": "81912063",
"name": "Doubleroom Deluxe with balcony",
"rooms_available": 1,
"rates": [
{
"id": 66118004,
"name": "Conform arrangement",
"rate_available": true,
"total_price": 200
},
{
"id": 82010274,
"name": "Bubbles arrangement",
"rate_available": false,
"reasons": ["closedonarrival", "minstay"]
}
]
}
]
Lezen, aanmaken, wijzigen en annuleren. Updates zijn partieel: je stuurt alleen wat verandert. Kies een resource en zie welke endpoints erbij horen.
/api/v1/bookings
Lijst, ophalen, aanmaken, wijzigen en annuleren. Ook gasten lezen en bijwerken, en boekingen aan elkaar koppelen.
/bookings
Boekingen tussen twee data
/bookings/current-bookings
Wie er nu verblijft
/bookings/from-debtor
Boekingen van een debiteur
/bookings/{BOOKING_ID}
Eén boeking ophalen
/bookings
Boeking aanmaken
/bookings/{BOOKING_ID}
Boeking wijzigen
/bookings/{BOOKING_ID}
Boeking annuleren
/bookings/{BOOKING_ID}/attach
Koppelen aan een hoofdboeking
/bookings/{BOOKING_ID}/detach
Loskoppelen
/bookings/{BOOKING_ID}/guests
Gasten van een boeking
/bookings/{BOOKING_ID}/guests/{GUEST_ID}
Gast bijwerken
/api/v1/availability
Vrije kamertypes met het berekende totaal per tarief, en de reden als een tarief niet kan, zoals minstay of closedonarrival.
/api/v1/calendar
Prijzen, beschikbaarheid en restricties per dag ophalen, en in bulk aanpassen.
/api/v1/invoices
Facturen, regels en betalingen beheren, definitief maken en als pdf downloaden.
/invoices
Facturen in een periode
/invoices/{INVOICE_ID}
Eén factuur ophalen
/invoices
Losse factuur maken
/invoices/{INVOICE_ID}
Factuur wijzigen
/invoices/make-final/{INVOICE_ID}
Definitief maken
/invoices/{INVOICE_ID}
Proforma verwijderen
/invoices/{INVOICE_ID}/lines
Productregel toevoegen
/invoices/{INVOICE_ID}/lines/{LINE_ID}
Productregel wijzigen
/invoices/{INVOICE_ID}/lines/{LINE_ID}
Productregel verwijderen
/invoices/payments
Alle betalingen in een periode
/invoices/{INVOICE_ID}/payments
Betaling afboeken
/invoices/{INVOICE_ID}/payments/{PAYMENT_ID}
Betaling verwijderen
/invoices/{INVOICE_ID}/pdf
Factuur als pdf
/api/v1/debtors
De gasten en bedrijven die boeken en betalen: zoeken, aanmaken, wijzigen en verwijderen.
/api/v1/roomtypes
Kamertypes met hun kamers, zoals een tweepersoonskamer met kamer 4 en kamer 6.
/api/v1/price-rates
De tarieven per kamertype, zoals een weekendarrangement of een long stay.
/api/v1/products
Alles wat je naast de kamer verkoopt, zoals eindschoonmaak of ontbijt, per gast of per nacht.
/api/v1/product-categories
Producten ordenen met een naam en een kleur.
/api/v1/vouchers
Vouchers en kortingscodes voor de boekingsmodule beheren vanuit je eigen systeem.
/api/v1/tax-rates
Btw-tarieven beheren: een label, het percentage en de soort.
/api/v1/property
Adres- en bedrijfsgegevens van het bedrijfsprofiel achter het token.
Drie calls die je vrijwel zeker nodig hebt, in curl, PHP of JavaScript. Kopiëren, token erin, draaien.
/bookings
curl -X POST https://app.mytourist.cloud/api/v1/bookings \
-H "Authorization: Bearer $MYTOURIST_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"arrival": "2030-07-01",
"departure": "2030-07-04",
"roomtype_id": "81912063",
"rate_id": "66118004",
"number_of_guests": 2,
"debtor_id": "23192010294",
"channel": "api",
"channel_reference": "WEB-10482"
}'
$client = new GuzzleHttp\Client(['base_uri' => 'https://app.mytourist.cloud/api/v1/']);
$res = $client->post('bookings', [
'headers' => ['Authorization' => 'Bearer ' . getenv('MYTOURIST_TOKEN')],
'json' => [
'arrival' => '2030-07-01',
'departure' => '2030-07-04',
'roomtype_id' => '81912063',
'rate_id' => '66118004',
'number_of_guests' => 2,
'channel_reference' => 'WEB-10482',
],
]);
$booking = json_decode($res->getBody(), true);
echo $booking['invoice']['total_amount_incl_vat']; // 200
const res = await fetch('https://app.mytourist.cloud/api/v1/bookings', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.MYTOURIST_TOKEN}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
arrival: '2030-07-01',
departure: '2030-07-04',
roomtype_id: '81912063',
rate_id: '66118004',
number_of_guests: 2,
channel_reference: 'WEB-10482',
}),
});
const booking = await res.json(); // booking.id, booking.invoice
{
"id": 231920102956,
"state": "confirmed",
"arrival": "2030-07-01",
"departure": "2030-07-04",
"roomtype": {
"id": "81912063",
"name": "Doubleroom Deluxe with balcony",
"placed_in_room": "Room 6"
},
"number_of_guests": 2,
"rate": { "id": "66118004", "name": "Conform arrangement" },
"channel": { "label": "api", "reference": "WEB-10482" },
"invoice": {
"id": "P1020077",
"total_amount_incl_vat": 200,
"has_amount_to_pay": true
}
}
/invoices/{INVOICE_ID}
curl https://app.mytourist.cloud/api/v1/invoices/P1020077 \
-H "Authorization: Bearer $MYTOURIST_TOKEN"
# Or as a PDF
curl https://app.mytourist.cloud/api/v1/invoices/P1020077/pdf \
-H "Authorization: Bearer $MYTOURIST_TOKEN" -o invoice.pdf
$res = $client->get('invoices/P1020077', [
'headers' => ['Authorization' => 'Bearer ' . getenv('MYTOURIST_TOKEN')],
]);
$invoice = json_decode($res->getBody(), true);
foreach ($invoice['product_lines'] as $line) {
echo $line['description'] . ': ' . $line['price_incl_vat'] . PHP_EOL;
}
const res = await fetch('https://app.mytourist.cloud/api/v1/invoices/P1020077', {
headers: { 'Authorization': `Bearer ${process.env.MYTOURIST_TOKEN}` },
});
const invoice = await res.json();
const open = invoice.financial_state === 'open';
{
"id": "P1020077",
"type": "proforma",
"financial_state": "open",
"reservation": "231920102956",
"reference": "PO-12345",
"product_lines": [
{
"type": "logies",
"description": "Doubleroom with balcony - 3 night(s) - 2 guest(s)",
"price_incl_vat": "200.00",
"tax_rate": "9.00"
}
],
"tourist_tax": { "amount": "0.00", "based_on_guests": 0 },
"payments": []
}
https://your-app.example/hooks/mytourist
# Simulate a webhook on your own machine
curl -X POST http://localhost:3000/hooks/mytourist \
-d trigger=booking_checkin \
-d id=231920102956 \
-d 'roomtype[placed_in_room]=Room 6'
// Webhooks arrive as form fields, nested data as arrays
$trigger = $_POST['trigger'] ?? null;
if ($trigger === 'booking_checkin') {
$room = $_POST['roomtype']['placed_in_room'];
unlockDoor($room); // your own code
}
http_response_code(200); // anything else is retried
// Express: webhooks arrive as form fields
app.use(express.urlencoded({ extended: true }));
app.post('/hooks/mytourist', (req, res) => {
const { trigger, id } = req.body;
if (trigger === 'booking_created') {
notifyTeam(`New booking ${id}`); // your own code
}
res.sendStatus(200); // anything else is retried
});
{
"trigger": "booking_checkin",
"id": 231920102956,
"state": "confirmed",
"arrival": "2030-07-01",
"departure": "2030-07-04",
"roomtype": { "placed_in_room": "Room 6" },
"access_code": "4711",
"checkin_at": "2030-07-01 15:42:10"
}
Stop met pollen. Kies in MyTourist een trigger en een https-URL, en bij elke gebeurtenis sturen we een POST met het veld trigger en de volledige data. Bij een boeking is dat dezelfde data als bij het ophalen van een boeking.
Antwoord met 200 en de levering is gelukt. Anders proberen we het opnieuw na 5, 15 en 60 minuten. Tip: test eerst met webhook.site.
booking_created
Er is een boeking gemaakt
booking_updated
Een boeking is gewijzigd
booking_cancelled
Een boeking is geannuleerd
booking_checkin
Een gast is ingecheckt
booking_checkout
Een gast is uitgecheckt
debtor_created
Er is een debiteur bijgekomen
debtor_updated
Een debiteur is gewijzigd
payment_received
Er is een betaling binnen
Een paar ideeën om mee te beginnen. Onder elke kaart staat de route door de API.
Check beschikbaarheid en tarieven, maak de boeking aan en haal de factuur op, gewoon in je eigen website of app.
GET /availability
POST /bookings
Maak bij elke nieuwe boeking een code aan in je slotsysteem en schrijf hem terug in access_code, zodat hij in de gastmail staat.
booking_created
POST /bookings/{id}
Zet verkopen uit de bar of winkel als productregel op de factuur van de gast en boek de betaling af.
POST /invoices/{id}/lines
POST /invoices/{id}/payments
Haal boekingen, facturen en betalingen per periode op en rapporteer op je eigen manier.
GET /bookings
GET /invoices/payments
Plan een schoonmaakbeurt zodra een gast uitcheckt, in de planningstool die je team al gebruikt.
booking_checkout
GET /bookings/current-bookings
Zet nieuwe gasten direct in je CRM of mailtool en houd hun gegevens daar actueel.
debtor_created
debtor_updated
In MyTourist onder Koppelingen > API. Eén token per bedrijfsprofiel, en te resetten: de oude stopt meteen.
Er is geen aparte sandbox. Maak een proefprofiel aan en laat Support daar de API en webhooks openzetten.
Laad de Postman-collectie of openapi.json. Recente API-calls toont je verkeer, elke 10 seconden ververst.
Maximaal 10 requests per 10 seconden. Cache wat je vaak nodig hebt, dan blijf je ruim onder de limiet.
Nog geen account? Bekijk eerst de prijzen van MyTourist.
Staat je vraag er niet bij? We helpen je graag verder, in het Nederlands, Engels of Duits.
Neem contact opGeen betaalgegevens nodig.
Liever eerst zien hoe het werkt? Bekijk de livedemo