BechinBerim docs.bechinberim.com
Getting Started
Overview
Authentication
Error Codes
Hotel API
GET Search Hotels
GET Hotel Details
POST Book Room
GET Reservations
DEL Cancel Booking
Products API
GET List Products
GET Product Details
POST Place Order
GET Order Status

BechinBerim API

The official API for travel agencies and partners to integrate hotel booking and travel products — WiFi modems, SIMs, and more — directly into their platforms.

REST · JSON HTTPS only v1.0

Available APIs v1.0

Two APIs, one authentication key. Build end-to-end travel experiences for your customers.

Hotel Booking API

Search hotels, check real-time availability, manage reservations and handle cancellations.

Travel Products API

Browse and order travel products including pocket WiFi modems, SIM cards, and accessories.

BASE URL https://api.bechinberim.com/v1

Authentication

All requests must include your API key in the Authorization header.

Your API Key
bb_live_••••••••••••••••••••••••••••••••
Keep your key secret. Do not expose it in client-side code or public repositories. Rotate it immediately if compromised.
Required headers
Authorization stringrequired Bearer YOUR_API_KEY
Content-Type stringrequired application/json
curl https://api.bechinberim.com/v1/hotels/search \
  -H "Authorization: Bearer bb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G -d "city=Tehran&check_in=2025-06-01&check_out=2025-06-05"

Hotel Booking API

Search availability, retrieve hotel details, create and manage bookings.

GET /hotels/search Search available hotels
Query parameters
citystringrequiredCity name or IATA code (e.g. Tehran, THR)
check_indaterequiredCheck-in date — YYYY-MM-DD
check_outdaterequiredCheck-out date — YYYY-MM-DD
guestsintegeroptionalNumber of guests. Default: 1
starsintegeroptionalMinimum star rating (1–5)
limitintegeroptionalResults per page. Default: 20, Max: 100
200 OK 401 Unauthorized 422 Validation Error
GET /hotels/{hotel_id} Hotel details
Path parameters
hotel_idstringrequiredUnique hotel identifier
200 OK 401 Unauthorized
POST /hotels/bookings Create a booking
Request body
hotel_idstringrequiredHotel identifier from search results
room_idstringrequiredRoom type identifier
guest_namestringrequiredFull name of the primary guest
guest_emailstringrequiredGuest email for confirmation
check_indaterequiredCheck-in date — YYYY-MM-DD
check_outdaterequiredCheck-out date — YYYY-MM-DD
special_requestsstringoptionalAny special notes or requests
201 Created 401 Unauthorized 422 Validation Error 500 Server Error
GET /hotels/bookings List reservations
Query parameters
statusstringoptionalFilter by status: active, cancelled, completed
from_datedateoptionalFilter bookings from this date
200 OK 401 Unauthorized
DELETE /hotels/bookings/{booking_id} Cancel a booking
Path parameters
booking_idstringrequiredUnique booking reference ID
200 OK 401 Unauthorized

Travel Products API

Access travel accessories including pocket WiFi modems, SIM cards, and more.

GET /products List all products
Query parameters
categorystringoptionalFilter by: modem, sim, accessory
destinationstringoptionalCountry code (ISO 3166-1 alpha-2, e.g. IR, TR)
limitintegeroptionalResults per page. Default: 20, Max: 100
200 OK 401 Unauthorized
GET /products/{product_id} Product details
Path parameters
product_idstringrequiredUnique product identifier
200 OK 401 Unauthorized
POST /products/orders Place a product order
Request body
product_idstringrequiredProduct identifier from listing
quantityintegerrequiredNumber of units to order
delivery_addressobjectrequiredShipping address: street, city, country, postal_code
agency_refstringoptionalYour internal reference number for reconciliation
201 Created 401 Unauthorized 422 Validation Error
GET /products/orders/{order_id} Order status
Path parameters
order_idstringrequiredUnique order identifier returned after placing an order
200 OK 401 Unauthorized