List trips
Returns Baydaar’s published trips, with prices and upcoming departures.
GEThttps://baydaarexperiences.com/api/v1/trips
Query parameters
All optional. Combine them freely.
| Parameter | Type | Description |
|---|---|---|
category | string | domestic or international. |
region | string | Case-insensitive match on the trip’s region or location, e.g. Gilgit, Hunza. |
q | string | Free-text search over title, location, region and short description. |
experience_type | string | leisure or adventure. |
available | boolean | true hides sold-out trips; false returns only sold-out ones. |
min_price / max_price | integer | Per-person price range in PKR (the “from” price). |
min_days / max_days | integer | Trip length range, in days. |
departs_after / departs_before | date | Only trips with at least one upcoming departure in this range (YYYY-MM-DD, inclusive). |
fields | string | Comma-separated top-level fields to return, e.g. id,title,price — smaller responses. |
sort | string | recommended (default — the order Baydaar chooses), price_asc, price_desc, duration_asc, duration_desc, departure (soonest first). |
limit | integer | Page size, 1–100. Default 25. |
offset | integer | Number of trips to skip. Default 0. |
Response
data is an array of trips; meta tells you how many matched. Page through with offset until has_more is false.
Trip object
| Parameter | Type | Description |
|---|---|---|
id | string | Stable identifier. Use it in /trips/{id}. |
title, short_description, description | string | Marketing copy, plain text. |
url / book_url | string | Where the trip is shown and booked on Baydaar. Link travellers here. |
category | string | domestic or international. |
location, region | string | e.g. Hunza, Gilgit-Baltistan. |
duration_days, duration_nights | integer | Nights are days − 1. |
price.currency | string | Always PKR. |
price.per_person | integer | Whole rupees. When the trip is priced by room sharing this is the cheapest option (show it as “from”). |
price.options | array | Room-sharing prices, cheapest first: [{ label, per_person }]. Empty when there is one price. |
price.usd_per_person | integer | null | Set only on trips Baydaar markets in dollars. A rupee trip is never converted — this stays null. |
price.advance_percent | integer | Share paid to secure a seat (50). The rest is paid on the day of departure. |
cover_image, images | string(s) | Absolute image URLs. |
included, excluded | string[] | What the price covers. |
itinerary | array | Day-by-day: { day, title, description }. |
activity_type, experience_type | string | null | e.g. Group Tour; leisure or adventure. |
sold_out | boolean | The whole trip is full, or every upcoming departure is. |
next_departure | date | null | Earliest upcoming departure that still has seats. |
departures | array | Upcoming departures only, soonest first: { date, return_date, spots_left, sold_out }. |
rating | object | null | { average, count } from traveller reviews, or null if none yet. |