get_baggage
Get detailed baggage list with dimensions, weight limits, and pricing for specific routes.
Endpoint: https://test-api.bussystem.eu/server/curl/get_baggage.php
Method: POST
Type: Optional function
Description
This function provides detailed baggage information for routes that support it. You can only use this request if the get_routes
response contains request_get_baggage = 1
.
Alternative Baggage Information
Baggage information is also available in other endpoints:
get_routes
: Thecomfort
tag may contain1_baggage_free
parameter and theluggage
tag provides general text informationget_all_routes
: Thebaggage
tag may contain detailed baggage information similar toget_baggage
Parameters
Authentication
Parameter | Type | Required | Description |
---|---|---|---|
login | string | ✓ | Your API login |
password | string | ✓ | Your API password |
session | string | Your session (recommended for additional routes) |
Route Information
Parameter | Type | Required | Description |
---|---|---|---|
interval_id | string | ✓ | Interval ID from get_routes response |
station_from_id | integer | ✓ | Departure station ID |
station_to_id | integer | ✓ | Arrival station ID |
Response Options
Parameter | Type | Description |
---|---|---|
currency | enum | Response currency: EUR , RON , PLN , MDL , RUB , UAH , CZK |
lang | enum | Response language: en , ru , ua , de , pl , cz |
Request Example
$url = 'https://test-api.bussystem.eu/server/curl/get_baggage.php';
$post_data = [
"login" => "your_login",
"password" => "your_password",
"interval_id" => "90|gh340|d29-96",
"station_from_id" => 1547,
"station_to_id" => 757,
"currency" => "EUR",
"lang" => "en"
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $post_data
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Response Example
[
{
"baggage_id": "81",
"baggage_type_id": "1",
"baggage_type": "small_baggage",
"baggage_type_abbreviated": "БАГАЖ М/М",
"baggage_title": "Hand baggage",
"length": "35",
"width": "10",
"height": "10",
"kg": "5",
"max_in_bus": "10",
"max_per_person": "1",
"typ": "route",
"price": "0",
"currency": "EUR"
},
{
"baggage_id": "82",
"baggage_type_id": "1",
"baggage_type": "small_baggage",
"baggage_type_abbreviated": "БАГАЖ М/М",
"baggage_title": "Hand baggage",
"length": "35",
"width": "10",
"height": "10",
"kg": "5",
"max_in_bus": "20",
"max_per_person": "2",
"typ": "route",
"price": "5",
"currency": "EUR"
},
{
"baggage_id": "84",
"baggage_type_id": "2",
"baggage_type": "medium_baggage",
"baggage_type_abbreviated": "БАГАЖ С/М",
"baggage_title": "Cabin baggage",
"length": "50",
"width": "25",
"height": "15",
"kg": "8",
"max_in_bus": "15",
"max_per_person": "2",
"typ": "route",
"price": "10",
"currency": "EUR"
},
{
"baggage_id": "86",
"baggage_type_id": "3",
"baggage_type": "large_baggage",
"baggage_type_abbreviated": "БАГАЖ С/М",
"baggage_title": "Large baggage",
"length": "55",
"width": "35",
"height": "20",
"kg": "25",
"max_in_bus": "10",
"max_per_person": "1",
"typ": "route",
"price": "15",
"currency": "EUR"
}
]
Response Fields Reference
Baggage Identification
Field | Type | Description |
---|---|---|
baggage_id | string | Critical: Baggage ID (required for new_order ) |
baggage_type_id | string | Baggage type identifier |
baggage_type | string | Baggage category (small_baggage, medium_baggage, large_baggage) |
baggage_type_abbreviated | string | Abbreviated baggage type name |
baggage_title | string | Human-readable baggage name |
Physical Specifications
Field | Type | Description |
---|---|---|
length | string | Maximum baggage length (centimeters) |
width | string | Maximum baggage width (centimeters) |
height | string | Maximum baggage height (centimeters) |
kg | string | Maximum baggage weight (kilograms) |
Availability Limits
Field | Type | Description |
---|---|---|
max_in_bus | string | Maximum pieces of this baggage type allowed on bus |
max_per_person | string | Maximum pieces of this baggage type per passenger |
typ | string | Baggage scope (typically “route”) |
Pricing Information
Field | Type | Description |
---|---|---|
price | string | Baggage fee (0 for free baggage) |
currency | string | Price currency |
Baggage Types
Small Baggage (Hand Baggage)
- Typical dimensions: 35×10×10 cm
- Weight limit: Up to 5 kg
- Usage: Carry-on items, personal belongings
- Pricing: Often free (price = 0) or low cost
Medium Baggage (Cabin Baggage)
- Typical dimensions: 50×25×15 cm
- Weight limit: Up to 8 kg
- Usage: Small suitcases, travel bags
- Pricing: Moderate fee
Large Baggage
- Typical dimensions: 55×35×20 cm
- Weight limit: Up to 25 kg
- Usage: Full-size suitcases, large travel bags
- Pricing: Higher fee
Error Responses
Dealer Not Active
{
"error": "dealer_no_activ",
"detal": "Dealer not active"
}
Route Not Active
{
"error": "route_no_activ"
}
Route Not Found
{
"error": "interval_no_activ"
}
No Baggage Available
[
{
"error": "baggage_not_found"
}
]