Skip to content
Rate Extra

Frequently asked questions

Answers from every page in one place: eligibility, currencies, references, licensing, and each product's most common questions.

General

Who can apply?

Licensed travel agencies only. We ask for your licence number and trade licence during the application.

Which currencies do you contract and settle in?

AED, USD, EUR, GBP and TRY.

Is there a public API reference?

Yes. The TravelDistro API reference is public at api.traveldistro.com/docs. The UAE Visa API is in early access and is not yet in the public reference.

Is the Hotel API a Rate Extra product?

No. The Hotel API is provided and contracted by Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.), Istanbul. It is available to Rate Extra partners.

Where are you licensed?

In Dubai, by the Department of Economy and Tourism (DET). License No. 1253634, Register No. 2115485.

Products

TravelDistro

Do I need a separate contract per product?

No. One contract with Rate Extra lists the verticals you can call; the same key and balance serve all of them.

Can I use a Bearer token?

No. Every request is signed with TD-HMAC-SHA256. See the authentication page for a working example.

What happens when I call a product outside my contract?

The API answers 403 MODULE_NOT_ENABLED on every endpoint that product owns. Nothing is booked or charged.

Is there a sandbox?

TravelDistro does not expose a separate sandbox host in the public reference. The Hotel API by Safaryar Holidays has a sandbox flag; other products are tested with your live key against small, cancellable bookings agreed with our onboarding team.

Where is the API reference?

Public at api.traveldistro.com/docs, with an OpenAPI file at /docs/openapi.yaml.

UAE Visa API

Is the UAE Visa API in the public API reference?

Not yet. It is in early access; request access and we share the integration guide after contracting.

Which visa types can I apply for?

Single entry and multiple entry UAE visas. Official validity and stay rules are set by the UAE authorities; we do not restate them here.

How long does processing take?

On average 48 working hours from a complete application.

Who can use it?

Licensed travel agencies with a signed Rate Extra contract.

Transfer API

Which cities are covered?

Istanbul and Antalya, including airport routes (IST, SAW, AYT).

How long is a quoted price valid?

Each offer carries a quote_expires_at timestamp; the price is locked until then.

Do I have to poll for confirmation?

No. Booking confirms in the response; later changes such as driver assignment arrive by signed webhook.

Can I change traveller details after booking?

Yes, with a PATCH on the booking. Cancellation follows the policy returned with the offer.

Tours & Activities API

Where are the tours?

Istanbul and Antalya.

Are prices cached?

No. Every search or quote resolves live and returns a quote_token that locks the price for booking.

How are vouchers delivered?

By API, per booking; ticket vouchers may be session-scheduled.

In which languages is tour content available?

A tour is published in a locale only after ops review and an approved translation for that locale.

eSIM API

Which countries are covered?

The catalog is worldwide; the exact package list per country comes from the API.

How fast is delivery?

Instant after the order confirms; installation instructions are returned with the order.

Can I check usage?

Yes, per ICCID, and you can top up an existing eSIM.

Are prices live?

Yes. Search and quote resolve live; you never sell off a stale price.

Flights API

Is ticketing a separate step?

No. Booking returns a confirmed, ticketed booking in one call.

How are refunds handled?

Cancellation refunds your wallet according to the refund tier that applies to the fare.

Are prices in my currency?

Itineraries are priced with your markup and FX applied at search time.

Which carriers are available?

Coverage is confirmed with your onboarding team during contracting.

Hotel API

Is the Hotel API a Rate Extra product?

No. It is provided and contracted by Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.), an affiliated company in Istanbul. Rate Extra partners can access it.

Is there a sandbox?

Yes. Requests with "sandbox": true use real hotel data and prices without charging balance.

How many rooms per booking?

Up to 9 rooms on direct (OWN) contracts, with single-room cancellation.

How is hotel mapping done?

With GIATA codes, in batches of up to 500.

Which webhooks exist?

booking.created, booking.cancelled, booking.prebook_confirmed and booking.prebook_rejected, signed with X-Webhook-Signature.

Rental Car API

How are offers structured?

One priced offer per vehicle class, each with a quote that locks the price for booking.

How is the booking paid?

From your prepaid wallet balance, like every other TravelDistro product.

Which locations are available?

The locations catalog is returned by the API; coverage is confirmed with your onboarding team.

Is this in the public reference?

Yes, in the TravelDistro API reference.

City Pass API

What is inside a pass?

A bundle of entitlements defined per product: museum entries, a boat tour, a transfer, an eSIM, an audio guide.

How are entitlements redeemed?

Through entitlement requests and vouchers issued per pass.

Which cities?

The pass catalog returned by the API states the city for each product.

Can I combine it with other products?

Yes; the same key and balance serve every vertical in your contract.

Audio Guide API

Does the guest need an account?

No. The guest scans the QR pass; the device calls /guide/v1 with the pass code.

Can I use my own app?

Yes. The visitor API is white-label; build a branded guest app on it.

Is there a ready-made app?

Yes, Rivayet, available on the App Store and Google Play.

Can I see usage?

Yes, through the usage statistics endpoint.

Luggage Storage API

How is time counted?

In started 24-hour blocks.

How are large items priced?

An oversize item counts as two bags.

Who runs the counters?

Counters are run by us; locations are listed by the API.

Can a booking be cancelled?

Yes, through the cancellation endpoint.

MICE Venues API

Can I book instantly?

No. Venues work by RFP: you submit a request, our ops team negotiates, you accept or decline the offer.

Which country is covered?

Türkiye.

In which language is the catalog?

English in this phase.

How do I keep the catalog in sync?

Incrementally, with the updated_since parameter.

TripXtra

Does TripXtra replace travel cover?

No. TripXtra is an assistance and support card. It is not a policy and does not replace travel cover.

Who issues the card?

Your agency, via API, after a commercial agreement with Rate Extra.

What does the traveller get?

A 24/7 support line, lawyer access through a partner law firm with a 60-minute emergency callback, lost passport support, dispute help and trip extras.

Can I co-brand it?

Yes, as "powered by TripXtra".

B2B Portal

Do I need developers?

No. The portal is a web application; the same contract also covers API access if you integrate later.

Are portal prices the same as API prices?

Yes. Same products, same prices, same wallet.

Where do I log in?

Partners receive the portal address with their account after onboarding.

Can I switch to the API later?

Yes, under the same contract.

White-label

What can be white-labelled today?

The audio guide guest experience, through the visitor API, and the TripXtra card as "powered by TripXtra".

Do I need my own app?

For the audio guide, you can build one on the visitor API or use Rivayet.

Is there extra cost?

Scope and terms are agreed during contracting.

Is it licensed-agency only?

Yes, like every Rate Extra product.

Settlement & Billing

Which currencies?

AED, USD, EUR, GBP and TRY.

Is it prepaid?

Yes. Bookings debit a prepaid wallet; a 429 or a failed booking charges nothing.

Can I read my statement by API?

Yes: account, wallet balance, wallet statement and currency rates are available over the API.

Who issues the invoice?

Rate Extra Tourism L.L.C, Dubai, except for the Hotel API, which is contracted with Safaryar Holidays.

Licensed travel agency? Apply for API access.

Get API access