test

We gebruiken cookies om content en advertenties te personaliseren en om ons websiteverkeer te analyseren. Ook delen we informatie over het gebruik van onze site met onze partners voor advertenties en analyses. Deze partners kunnen deze gegevens combineren met andere informatie die je aan ze hebt verstrekt of die ze hebben verzameld op basis van je gebruik van hun services.

REST API v1 / JSON / Webhooks

MyTourist API voor developers Jouw code. Onze boekingsdata.

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.

OpenAPI 3.0 Postman curl, PHP, JavaScript
~/my-booking-site bash
$ curl -G https://app.mytourist.cloud/api/v1/availability \
  -H "Authorization: Bearer $MYTOURIST_TOKEN" \
  -d arrival=2030-07-01 \
  -d departure=2030-07-04
200 OK application/json
[
  {
    "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"]
      }
    ]
  }
]
56
endpoints in 12 resources
8
webhook-triggers
3×
retry na 5, 15 en 60 minuten
24
maanden log van elke call
De API

Wat je met de MyTourist API kunt

Lezen, aanmaken, wijzigen en annuleren. Updates zijn partieel: je stuurt alleen wat verandert. Kies een resource en zie welke endpoints erbij horen.

/api/v1/availability

Beschikbaarheid

Vrije kamertypes met het berekende totaal per tarief, en de reden als een tarief niet kan, zoals minstay of closedonarrival.

/api/v1/roomtypes

Kamertypes

Kamertypes met hun kamers, zoals een tweepersoonskamer met kamer 4 en kamer 6.

/api/v1/price-rates

Prijstarieven

De tarieven per kamertype, zoals een weekendarrangement of een long stay.

/api/v1/property

Accommodatie

Adres- en bedrijfsgegevens van het bedrijfsprofiel achter het token.

Codevoorbeeld

Probeer de API zelf

Drie calls die je vrijwel zeker nodig hebt, in curl, PHP of JavaScript. Kopiëren, token erin, draaien.

POST /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
Response 200 OK
{
  "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
  }
}
GET /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';
Response 200 OK
{
  "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": []
}
POST 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
});
Wat jouw endpoint ontvangt 200 OK
{
  "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"
}
Webhooks

Webhooks: ontvang boekingen en betalingen direct

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
Toepassingen

Wat developers ermee bouwen

Een paar ideeën om mee te beginnen. Onder elke kaart staat de route door de API.

Eigen boekflow

Check beschikbaarheid en tarieven, maak de boeking aan en haal de factuur op, gewoon in je eigen website of app.

GET /availability POST /bookings

Deurcode per boeking

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}

Kassa en bar

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

Dashboard of datawarehouse

Haal boekingen, facturen en betalingen per periode op en rapporteer op je eigen manier.

GET /bookings GET /invoices/payments

Schoonmaakplanning

Plan een schoonmaakbeurt zodra een gast uitcheckt, in de planningstool die je team al gebruikt.

booking_checkout GET /bookings/current-bookings

CRM of nieuwsbrief

Zet nieuwe gasten direct in je CRM of mailtool en houd hun gegevens daar actueel.

debtor_created debtor_updated
Aan de slag

In vier stappen live

  1. 01

    Pak je token

    In MyTourist onder Koppelingen > API. Eén token per bedrijfsprofiel, en te resetten: de oude stopt meteen.

  2. 02

    Test in een proefprofiel

    Er is geen aparte sandbox. Maak een proefprofiel aan en laat Support daar de API en webhooks openzetten.

  3. 03

    Importeer en kijk mee

    Laad de Postman-collectie of openapi.json. Recente API-calls toont je verkeer, elke 10 seconden ververst.

  4. 04

    Live, met cache

    Maximaal 10 requests per 10 seconden. Cache wat je vaak nodig hebt, dan blijf je ruim onder de limiet.

Alles wat je nodig hebt om te beginnen
Openbaar, zonder account te bekijken.

Nog geen account? Bekijk eerst de prijzen van MyTourist.

Veelgestelde vragen over de API

Staat je vraag er niet bij? We helpen je graag verder, in het Nederlands, Engels of Duits.

Neem contact op
Er zijn 56 endpoints voor boekingen, beschikbaarheid, de kalender, debiteuren, facturen, kamertypes, tarieven, producten en kortingscodes. De volledige lijst staat in de openbare API-docs, met een download van openapi.json en een Postman-collectie, en voorbeelden in curl, PHP en JavaScript.
Nee, MyTourist bouwt geen maatwerk. Support helpt wel bij vragen over de API zelf: endpoints, authenticatie en responses. In het Nederlands, Engels en Duits.
Er is geen aparte sandbox. Test in een proefprofiel: maak een nieuw bedrijfsprofiel aan en laat Support daar de API en webhooks openzetten. Zo blijft je echte administratie buiten schot.
10 requests per 10 seconden. Daarboven krijg je HTTP 429. Gebruik de lijst-endpoints met een periode in plaats van items één voor één op te halen, en cache wat je vaak nodig hebt, zoals kamertypes en tarieven.
Alles behalve HTTP 200 telt als mislukt. We proberen het opnieuw na 5, 15 en 60 minuten; daarna stoppen we. Antwoord dus snel met 200 en verwerk het bericht daarna.

Probeer MyTourist 7 dagen gratis en vrijblijvend

Geen betaalgegevens nodig.

  • Loopt niet vanzelf door
  • Maandelijks opzegbaar
  • Support in NL, EN en DE

Liever eerst zien hoe het werkt? Bekijk de livedemo

Patrick van MyTourist