Skip to content

Railways

Last Update: v2.5.0

POST /railways/search/ HTTP/1.1

Query Params
source : optional which source should used default 0

Request Body

Fields:
passengers.adt : Count of adults
passengers.chd : Count of childs
passengers.yng : Count of youngs
passengers.inf : Count of infants
routes : List of routes for search
routes.departure : departure station code
routes.arrival : arrival station code
routes.departure_date : departure date

Example

{
    "passengers": {
        "adt": 1,
        "chd": 0,
        "yng": 0,
        "inf": 0
    },
    "routes": [
        {
            "departure": "2900700",
            "arrival": "2900750",
            "departure_date": "2025-10-24"
        }
    ]
}

Response Body
room_id : uuid ID of search room

Example

{
  "status": "ok",
  "internal_code": 0,
  "http_code": 200,
  "data": {
      "room_id": "0e5fdbba-2d73-43d5-a587-8ec77d2fa159"
  },
  "errors": [],
  "messages": []
}


Obtain Trains

POST /railways/obtain-trains/ HTTP/1.1

Query Params
source : optional which source should used default 0
currency : currency, in which offers should be returned, length must be 3

Request Body
room_id : Room id from search response

Example

{
  "room_id": "0e5fdbba-2d73-43d5-a587-8ec77d2fa159"
}

Response Body
data : list[RailwaysTrainOffer]

Example
  {
    "status": "ok",
    "internal_code": 0,
    "http_code": 200,
    "data": [
        {
            "id": "0cd78295-a31c-4022-8c33-f1246b25334b",
            "railway_name": "Uzbekistan Railways",
            "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
            "train_type": "СКРСТ",
            "train_name": "",
            "trip_number": "704Ч",
            "departure": {
                "station": {
                    "code": "2900700",
                    "name_ru": "САМАРКАНД",
                    "name_en": "SAMARKAND",
                    "name_uz": "SAMARQAND",
                    "classification": 6,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "00:30:00",
                "timezone": "+5"
            },
            "arrival": {
                "station": {
                    "code": "2900750",
                    "name_ru": "КАРШИ",
                    "name_en": "KARSHI",
                    "name_uz": "QARSHI",
                    "classification": 1,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "02:29:00",
                "timezone": "+5"
            },
            "carriage_types": [
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Сидячий",
                    "available_seats": 39,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 133730.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:17"
                    },
                    "price": {
                        "amount": 133730.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 133730.0,
                        "currency": "UZS"
                    }
                }
            ],
            "route_stations": [
                "САМАРКАНД",
                "КАРШИ"
            ]
        },
        {
            "id": "cb2e88ee-ad2b-4caa-934d-6b337579f4fc",
            "railway_name": "Uzbekistan Railways",
            "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
            "train_type": "СК",
            "train_name": "",
            "trip_number": "080Ф",
            "departure": {
                "station": {
                    "code": "2900700",
                    "name_ru": "САМАРКАНД",
                    "name_en": "SAMARKAND",
                    "name_uz": "SAMARQAND",
                    "classification": 6,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "01:10:00",
                "timezone": "+5"
            },
            "arrival": {
                "station": {
                    "code": "2900750",
                    "name_ru": "КАРШИ",
                    "name_en": "KARSHI",
                    "name_uz": "QARSHI",
                    "classification": 1,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "02:58:00",
                "timezone": "+5"
            },
            "carriage_types": [
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Общий",
                    "available_seats": 79,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 73740.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:18"
                    },
                    "price": {
                        "amount": 73740.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 73740.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Плацкартный",
                    "available_seats": 62,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 119130.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:19"
                    },
                    "price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Купе",
                    "available_seats": 57,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 151150.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:21"
                    },
                    "price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "СВ",
                    "available_seats": 10,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 244730.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:22"
                    },
                    "price": {
                        "amount": 244730.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 244730.0,
                        "currency": "UZS"
                    }
                }
            ],
            "route_stations": [
                "ТАШКЕНТ ЮЖ",
                "ТЕРМЕЗ"
            ]
        },
        {
            "id": "25cddc36-3a0f-40ba-88ff-efa3353bc6e8",
            "railway_name": "Uzbekistan Railways",
            "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
            "train_type": "СК",
            "train_name": "",
            "trip_number": "082Ф",
            "departure": {
                "station": {
                    "code": "2900700",
                    "name_ru": "САМАРКАНД",
                    "name_en": "SAMARKAND",
                    "name_uz": "SAMARQAND",
                    "classification": 6,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "01:10:00",
                "timezone": "+5"
            },
            "arrival": {
                "station": {
                    "code": "2900750",
                    "name_ru": "КАРШИ",
                    "name_en": "KARSHI",
                    "name_uz": "QARSHI",
                    "classification": 1,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "02:58:00",
                "timezone": "+5"
            },
            "carriage_types": [
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Плацкартный",
                    "available_seats": 130,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 119130.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:23"
                    },
                    "price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Купе",
                    "available_seats": 39,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 151150.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:24"
                    },
                    "price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "СВ",
                    "available_seats": 9,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 244730.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:26"
                    },
                    "price": {
                        "amount": 244730.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 244730.0,
                        "currency": "UZS"
                    }
                }
            ],
            "route_stations": [
                "ТАШКЕНТ ЮЖ",
                "САРЫАСИЯ"
            ]
        },
        {
            "id": "c64ec595-7129-4632-aee9-6bd890af1971",
            "railway_name": "Uzbekistan Railways",
            "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
            "train_type": "СК",
            "train_name": "",
            "trip_number": "129Ф",
            "departure": {
                "station": {
                    "code": "2900700",
                    "name_ru": "САМАРКАНД",
                    "name_en": "SAMARKAND",
                    "name_uz": "SAMARQAND",
                    "classification": 6,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "03:40:00",
                "timezone": "+5"
            },
            "arrival": {
                "station": {
                    "code": "2900750",
                    "name_ru": "КАРШИ",
                    "name_en": "KARSHI",
                    "name_uz": "QARSHI",
                    "classification": 1,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "05:34:00",
                "timezone": "+5"
            },
            "carriage_types": [
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Плацкартный",
                    "available_seats": 144,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 119130.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:27"
                    },
                    "price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 119130.0,
                        "currency": "UZS"
                    }
                },
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Купе",
                    "available_seats": 17,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 151150.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:28"
                    },
                    "price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 151150.0,
                        "currency": "UZS"
                    }
                }
            ],
            "route_stations": [
                "АНДИЖАН 1",
                "ТЕРМЕЗ"
            ]
        },
        {
            "id": "53b70302-4644-437a-a33d-b35dc5234d75",
            "railway_name": "Uzbekistan Railways",
            "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
            "train_type": "СКРСТ",
            "train_name": "",
            "trip_number": "716Ф",
            "departure": {
                "station": {
                    "code": "2900700",
                    "name_ru": "САМАРКАНД",
                    "name_en": "SAMARKAND",
                    "name_uz": "SAMARQAND",
                    "classification": 6,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "12:36:00",
                "timezone": "+5"
            },
            "arrival": {
                "station": {
                    "code": "2900750",
                    "name_ru": "КАРШИ",
                    "name_en": "KARSHI",
                    "name_uz": "QARSHI",
                    "classification": 1,
                    "country_code": 29
                },
                "date": "2025-11-22",
                "time": "14:05:00",
                "timezone": "+5"
            },
            "carriage_types": [
                {
                    "currency": "UZS",
                    "source_index": 0,
                    "type": "Сидячий",
                    "available_seats": 117,
                    "price_details": [
                        {
                            "passenger_type": "ADT",
                            "carriage_type": "",
                            "currency": "UZS",
                            "single_total_amount": 133730.0
                        }
                    ],
                    "rate": {
                        "from_currency": "UZS",
                        "to_currency": "UZS",
                        "rate": 1.0,
                        "update_datetime": "02.11.2025 19:27:29"
                    },
                    "price": {
                        "amount": 133730.0,
                        "currency": "UZS"
                    },
                    "base_price": {
                        "amount": 133730.0,
                        "currency": "UZS"
                    }
                }
            ],
            "route_stations": [
                "ТАШКЕНТ Ц",
                "КАРШИ"
            ]
        }
    ],
    "errors": [],
    "messages": []
}


Train Details

POST /railways/train-details/ HTTP/1.1

Query Params
source : optional which source should used default 0
currency : currency, in which offers should be returned, length must be 3

Request Body
room_id : Search room id
train_id : selected Train ID for obtain details

Example

  {
      "room_id": "0e5fdbba-2d73-43d5-a587-8ec77d2fa159", 
      "train_id": "8c847fd8-d95a-4fa0-a23c-660410a5f869"
  }

Response Body
data : RailwaysTrainDetails

Example
  {
      "status": "ok",
      "internal_code": 0,
      "http_code": 200,
      "data": {
          "id": "0cd78295-a31c-4022-8c33-f1246b25334b",
          "railway_logo": "https://dgov.uz/media/solutions/icons/Ozbekiston_temir_yollari-01-1024x1024_l2sOsta.png",
          "railway_name": "Uzbekistan Railways",
          "train_type": "СКРСТ",
          "trip_number": "704Ч",
          "trip_details": {
              "route_stations": [
                  "САМАРКАНД",
                  "КАРШИ"
              ],
              "departure": {
                  "station": {
                      "code": "2900700",
                      "name_ru": "САМАРКАНД",
                      "name_en": "SAMARKAND",
                      "name_uz": "SAMARQAND",
                      "classification": 6,
                      "country_code": 29
                  },
                  "date": "2025-11-22",
                  "time": "00:30:00",
                  "timezone": "+5"
              },
              "arrival": {
                  "station": {
                      "code": "2900750",
                      "name_ru": "КАРШИ",
                      "name_en": "KARSHI",
                      "name_uz": "QARSHI",
                      "classification": 1,
                      "country_code": 29
                  },
                  "date": "2025-11-22",
                  "time": "02:29:00",
                  "timezone": "+5"
              },
              "trip_time_minutes": 119
          },
          "carriage_types": [
              {
                  "type": "Сидячий",
                  "show_name": "Сидячий",
                  "carriages": [
                      {
                          "type": "Сидячий",
                          "carriage_id": "15d0b865-5bad-4664-bd18-c2668700a3c4",
                          "number": "16",
                          "total_seats": 39,
                          "start_price": {
                              "amount": 133730.0,
                              "currency": "UZS"
                          },
                          "seats": [
                              {
                                  "seat_number": "021",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "022",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "023",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "024",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "028",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "029",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "030",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "031",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "032",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "033",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "034",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "035",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "036",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "037",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "038",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              }
                          ],
                          "class_service": "2В",
                          "train_schema": "car-std-eco-class-39.svg",
                          "services": [],
                          "available_seats_count": 15
                      },
                      {
                          "type": "Сидячий",
                          "carriage_id": "9bc41a77-2c84-44d1-8b70-ba7f28b16cae",
                          "number": "18",
                          "total_seats": 39,
                          "start_price": {
                              "amount": 133730.0,
                              "currency": "UZS"
                          },
                          "seats": [
                              {
                                  "seat_number": "037",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              }
                          ],
                          "class_service": "2В",
                          "train_schema": "car-std-eco-class-39.svg",
                          "services": [],
                          "available_seats_count": 1
                      },
                      {
                          "type": "Сидячий",
                          "carriage_id": "b6bd2b60-369e-4386-b0ab-106922d71fb5",
                          "number": "19",
                          "total_seats": 39,
                          "start_price": {
                              "amount": 133730.0,
                              "currency": "UZS"
                          },
                          "seats": [
                              {
                                  "seat_number": "001",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "015",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "017",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "018",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "019",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "020",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "021",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "022",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "023",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "024",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "025",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "026",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "027",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "028",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "029",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "030",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "031",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "032",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "033",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "034",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "035",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "036",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              },
                              {
                                  "seat_number": "037",
                                  "additional_fee": {
                                      "amount": 0,
                                      "currency": "UZS"
                                  }
                              }
                          ],
                          "class_service": "2В",
                          "train_schema": "car-std-eco-class-39.svg",
                          "services": [],
                          "available_seats_count": 23
                      }
                  ],
                  "start_price": {
                      "amount": 133730.0,
                      "currency": "UZS"
                  },
                  "available_seats_count": 39
              }
          ]
      },
      "errors": [],
      "messages": []
  }


Booking

Query Params
source : optional which source should used default 0
currency : currency, in which offers should be returned, length must be 3

Request Body
room_id : str
train_id : str
carriage_id : str
seats : list[int]
contacts : RailwaysBookingContacts
passengers : list[RailwaysBookingPassenger]

Possible Exceptions:
GtsErrors
CommonExceptions
CommonOrderErrors