Travel Tips

Booking an Umrah package with the GNK API

GT Written by GNK Travel Team Published 12 September 2026 Reading time 1 min read
In this article
  1. 01 Before you start
  2. 02 Calling the search endpoint
  3. 03 Reading the response
  4. 04 Watch it end to end

Before you start

The GNK booking API is a small surface: search, hold, confirm. Everything below assumes a sandbox key from the keys page and a PHP 8.2 runtime.

This paragraph carries an inline handler that must not survive the save.

Calling the search endpoint

Send the traveller count and the departure window. The response is paginated.

curl -s https://api.gnktravel.com/v1/packages \
  -H "Authorization: Bearer $GNK_KEY" \
  -d city=makkah -d nights=7
  • Always send a currency, or you get SAR.
  • Hold expires after 20 minutes.
  • Confirm is idempotent on reference.

Reading the response

The Haram at dawn
Fares drop sharply outside the Ramadan window.
Field Type Notes
reference string Idempotency key
hold_expires_at ISO 8601 Always UTC

Watch it end to end

Book the flight before the hotel. Rooms move; seats do not.

That is the whole flow. Errors come back as RFC 7807 problem documents.

GT

Written by

GNK Travel Team

Travel Tips desk · GNK TRAVEL

Share

Concierge

Planning a trip like this?

Send us your dates and who is travelling. We'll come back with options and prices — flights, hotels and the paperwork included.

All articles

Keep reading

More from the blog

Travel insurance: what it actually covers
Travel Tips

7 May 2026 5 min read

Travel insurance: what it actually covers

Medical bills, cancellations and lost baggage — plus the exclusions that catch people out at the claim stage.

Read article
Your first Umrah: what actually happens, step by step
Hajj & Umrah Featured

26 Aug 2026 8 min read

Your first Umrah: what actually happens, step by step

From putting on ihram to your final tawaf — a plain account of the journey, so nothing on the ground comes as a surprise.

Read article

Ready to start your journey?

Tell us where you want to go and our travel experts will craft the perfect trip for you.