virginaustralia.com APIvirginaustralia.com ↗
Search Virgin Australia flights, retrieve fare calendars, list destinations, and fetch current specials via 4 structured API endpoints returning AUD pricing.
curl -X GET 'https://api.parse.bot/scraper/9eb50a88-02ea-40bc-a23c-18a1b06e0af8/search_flights?adults=1&origin=SYD&infants=0&children=0&cabin_class=ECONOMY&destination=MEL&award_booking=false&departure_date=2026-06-15' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for available flights between two airports on a specific date. Supports award (points) bookings. Returns detailed flight offers including pricing by fare family (Lite, Choice, Flex), segment details, and alternate date pricing.
| Param | Type | Description |
|---|---|---|
| adults | integer | Number of adult passengers |
| originrequired | string | Origin airport IATA code (e.g. SYD, MEL, BNE) |
| infants | integer | Number of infant passengers |
| children | integer | Number of child passengers |
| cabin_class | string | Cabin class: ECONOMY or BUSINESS |
| destinationrequired | string | Destination airport IATA code (e.g. MEL, SYD, BNE) |
| award_booking | boolean | Whether to search for award (points) bookings |
| departure_daterequired | string | Departure date in YYYY-MM-DD format |
{
"type": "object",
"fields": {
"currency": "string, currency code for all prices (e.g. AUD)",
"fareFamilies": "array of fare family definitions with brand IDs and marketing text",
"brandedResults": "object containing itinerary parts with brand-specific offers",
"unbundledOffers": "array of flight offer groups, each containing offers for different fare families (Lite, Choice, Flex) with pricing and segment details",
"unbundledAlternateDateOffers": "array of lowest-fare offers for nearby dates"
},
"sample": {
"data": {
"currency": "AUD",
"fareFamilies": [
{
"brandId": "LT",
"brandLabel": [
{
"marketingText": "Lite"
}
]
}
],
"brandedResults": {
"itineraryPartBrands": [
[]
]
},
"unbundledOffers": [
[
{
"total": {
"alternatives": [
[
{
"amount": 129,
"currency": "AUD"
}
]
]
},
"brandId": "LT",
"soldout": false,
"cabinClass": "Economy",
"itineraryPart": [
{
"segments": [
{
"flight": {
"airlineCode": "VA",
"flightNumber": 800
},
"origin": "SYD",
"arrival": "2026-06-15T07:35:00",
"duration": 95,
"departure": "2026-06-15T06:00:00",
"destination": "MEL"
}
]
}
]
}
]
],
"unbundledAlternateDateOffers": [
[
{
"total": {
"alternatives": [
[
{
"amount": 129,
"currency": "AUD"
}
]
]
},
"status": "AVAILABLE",
"brandId": "LT",
"departureDates": [
"2026-06-12"
]
}
]
]
},
"status": "success"
}
}About the virginaustralia.com API
The Virgin Australia API gives developers access to 4 endpoints covering flight search, fare calendars, available destinations, and current flight specials. The search_flights endpoint returns per-fare-family pricing across Lite, Choice, and Flex cabins, segment-level itinerary data, and alternate-date offers — all in a single response keyed by currency and branded fare definitions.
Flight Search and Fare Families
The search_flights endpoint accepts an origin and destination as IATA codes (e.g. SYD, MEL, BNE), a departure_date in YYYY-MM-DD format, and optional passenger counts for adults, children, and infants. Set cabin_class to ECONOMY or BUSINESS, or pass award_booking: true to retrieve points-based fares. The response includes unbundledOffers — an array of offer groups, each covering all three fare families — alongside fareFamilies definitions that carry brand IDs and marketing text. A separate unbundledAlternateDateOffers array exposes the cheapest fare for each nearby date, which makes it straightforward to surface a lowest-price suggestion without a second call.
Fare Calendar
The get_fare_calendar endpoint takes the same origin, destination, and cabin_class parameters but returns approximately 30 days of availability centered on the supplied departure_date. Each entry in unbundledAlternateDateOffers contains a departure date, availability status, and the lowest fare for that date, making it suitable for building a date-picker with live price annotations.
Destinations and Flight Specials
get_available_destinations requires no inputs and returns origins and destinations objects, each containing a geographicalRegions array. Every region entry includes a regionName, regionCode, and a list of airports — covering regions such as Australia, Asia Pacific, North America, and UK & Europe. This is the right starting point for populating route-selector UIs or validating IATA codes before passing them to other endpoints.
get_flight_specials also requires no inputs and returns sale fares keyed by lowercase origin IATA code. Each key maps to a port_name and a sale_items array that includes route details, pricing, and travel periods. This endpoint is well-suited for surfacing promotional fares on a deals page without needing to enumerate individual routes.
- Build a flight-search widget that shows Lite, Choice, and Flex fare pricing side-by-side for a given route and date.
- Render an interactive fare calendar with cheapest-per-day prices using
get_fare_calendaroutput. - Validate and populate airport dropdowns by region using
get_available_destinationsdata. - Display a live deals feed sourced from
get_flight_specialssale_items with travel period filtering. - Compare award (points) versus cash fares on the same route by toggling
award_bookinginsearch_flights. - Identify the cheapest nearby departure date by parsing
unbundledAlternateDateOffersfrom a flight search response. - Monitor fare movement across multiple routes by scheduling repeated
get_fare_calendarcalls and diffing results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Virgin Australia have an official public developer API?+
What does `search_flights` return beyond basic price and route?+
fareFamilies definitions with brand IDs, brandedResults with itinerary parts and brand-specific offers, unbundledOffers broken down by fare family (Lite, Choice, Flex) with full segment detail, and unbundledAlternateDateOffers with cheapest fares for surrounding dates — all expressed in a single currency code (typically AUD).Does the API cover multi-city or return-leg searches?+
search_flights endpoint covers one-way searches between a single origin and destination pair. Return and multi-city itinerary search is not currently included. You can fork this API on Parse and revise it to add a return-leg or multi-city endpoint.How far out does the fare calendar look?+
get_fare_calendar endpoint returns roughly 30 days of availability centered on the departure_date you supply. Each entry shows status and the lowest available fare for that date, but it does not return all fare-family breakdowns — those are only available through search_flights for a specific date.Does the API return seat maps or baggage allowance details?+
fareFamilies include marketing text that may reference inclusions, but structured baggage data fields are not part of the response. You can fork this API on Parse and revise it to add an endpoint covering ancillary or baggage data.