> ## Documentation Index > Fetch the complete documentation index at: https://docs.prexsell.com/llms.txt > Use this file to discover all available pages before exploring further. # Get schedule for a city pair on a date > Returns a dated timetable of individual departures for the given city pair. Each row includes departure/arrival datetime (wall-clock, timezone-aware), company, route name, travel time, and price. Sorted by departure time ascending. Paginated with take/skip. ## OpenAPI ````yaml /docs/openapi/openapi.json get /v2/offers/schedule openapi: 3.1.0 info: title: PREXSELL REST v2 version: 5.97.1 description: REST API for the PREXSELL bus booking management platform. servers: - url: https://staging.api.prexsell.com description: Staging - url: https://api.prexsell.com description: Production security: [] paths: /v2/offers/schedule: get: tags: - Offers summary: Get schedule for a city pair on a date description: >- Returns a dated timetable of individual departures for the given city pair. Each row includes departure/arrival datetime (wall-clock, timezone-aware), company, route name, travel time, and price. Sorted by departure time ascending. Paginated with take/skip. operationId: getOffersSchedule parameters: - schema: type: string minLength: 1 description: URL-friendly slug of the departure city. example: kyiv required: true description: URL-friendly slug of the departure city. name: departureCitySlug in: query - schema: type: string minLength: 1 description: URL-friendly slug of the arrival city. example: warsaw required: true description: URL-friendly slug of the arrival city. name: arrivalCitySlug in: query - schema: type: string format: date description: Travel date in ISO YYYY-MM-DD format. example: '2026-06-10' required: true description: Travel date in ISO YYYY-MM-DD format. name: date in: query - schema: type: integer minimum: 1 maximum: 10 default: 1 description: Number of passengers (1–10). example: 1 required: false description: Number of passengers (1–10). name: passengers in: query - schema: type: string enum: - UAH - PLN - CZK - EUR - USD default: UAH description: Currency code for prices. example: UAH required: false description: Currency code for prices. name: currency in: query - schema: type: string enum: - UK - PL - CS - EN - RU default: UK description: Language code for city name translations. example: UK required: false description: Language code for city name translations. name: language in: query - schema: type: integer minimum: 1 maximum: 100 default: 50 description: Maximum number of departures to return (1–100). example: 50 required: false description: Maximum number of departures to return (1–100). name: take in: query - schema: type: - integer - 'null' minimum: 0 default: 0 description: Number of departures to skip for offset pagination. example: 0 required: false description: Number of departures to skip for offset pagination. name: skip in: query responses: '200': description: Schedule of departures for the given city pair and date. content: application/json: schema: type: object properties: data: type: object properties: source: type: string enum: - PrexSell description: Data source identifier. example: PrexSell total: type: integer minimum: 0 description: >- Total number of departures matching the query (pre-pagination). example: 7 currency: type: string description: Currency used for price fields. example: UAH passengers: type: integer description: Number of passengers used for this query. example: 1 departures: type: array items: type: object properties: id: type: string description: >- Offer token (20-min JWT). Pass to the booking API. example: eyJ... company: type: object properties: id: type: string name: type: - string - 'null' slug: type: - string - 'null' logoUrl: type: - string - 'null' required: - id - name - slug - logoUrl additionalProperties: false description: Company identity (id, name, slug, logoUrl). departureDateTime: type: - string - 'null' description: >- ISO 8601 departure datetime with timezone offset. example: '2026-06-10T06:30:00+03:00' arrivalDateTime: type: - string - 'null' description: ISO 8601 arrival datetime with timezone offset. example: '2026-06-11T08:45:00+02:00' travelTimeMinutes: type: - integer - 'null' description: >- Total travel time in minutes (including transfer waits). example: 1575 routeName: type: - string - 'null' description: Route name of the first leg. example: Київ — Варшава price: type: object properties: amount: description: >- Ticket price in the requested currency (null if the offer has no price in that currency). example: 1450 currency: type: string description: Currency code. example: UAH required: - currency description: >- Price for the requested currency and passenger count. seatsLeft: type: integer description: >- Available seats (already ≥ requested passengers). example: 22 required: - id - company - departureDateTime - arrivalDateTime - travelTimeMinutes - routeName - price - seatsLeft description: A single departure on the schedule. description: Paginated list of departures. required: - source - total - currency - passengers - departures required: - data example: data: source: PrexSell total: 7 currency: UAH passengers: 1 departures: - id: eyJ... company: id: clco1 name: Ecolines slug: ecolines logoUrl: https://example.com/logo.png departureDateTime: '2026-06-10T06:30:00+03:00' arrivalDateTime: '2026-06-11T08:45:00+02:00' travelTimeMinutes: 1575 routeName: Київ — Варшава price: amount: 1450 currency: UAH seatsLeft: 22 '404': description: Standard error response body. content: application/json: schema: type: object properties: errors: type: array items: type: object properties: message: type: string example: AUTH_INVALID_CREDENTIALS errorCode: type: string example: UNAUTHORIZED details: {} required: - message required: - errors example: errors: - message: RESOURCE_NOT_FOUND errorCode: NOT_FOUND ````