African WingsBook a flight

Travel trade

Sell African Wings flights in your platform

Our partner API gives tour operators, DMCs and booking platforms such as TripsNStay live availability and booking requests for private charters, whale watching and scenic flights, and empty legs across Southern Africa.

Any routeDeparture and arrival are free text: towns, airports or lodge airstrips.
Instant requestsRequest with one call. We reply with a quote within a few working hours.
Status webhooksConfirmed, paid, flown or cancelled, pushed to your system.
Product feedJSON or CSV, ready for an extranet upload.

Getting started

  1. Email safari@africanwings.co.za to agree commercial terms and commission.
  2. We send your API key and webhook secret privately.
  3. Call GET /ping to check the key, then GET /products to load airports, aircraft and flights.

Base URL: https://www.africanwings.co.za/api/v1/partner · Machine-readable spec: openapi.yaml · Prices are not shared through the API: African Wings sends a personal quote for each request.

Authentication

Send your key on every request, server to server. Never place it in browser code.

curl https://www.africanwings.co.za/api/v1/partner/ping \
  -H "X-API-Key: awk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Authorization: Bearer awk_live_… also works.

Endpoints

MethodPathWhat it does
GET/pingChecks your key and shows your commission.
GET/productsSuggested airports, aircraft, scenic flights and live empty legs.
GET/feed?format=json|csvFlat product list for an extranet upload.
POST/quoteCheck which aircraft suit a charter, or whether a scenic time or empty leg is free.
GET/availability?productId=&date=Which departure times are free for a scenic flight.
POST/bookingsCreate a booking request. Supports Idempotency-Key.
GET/bookings/{ref}Read a booking you created.
POST/bookings/{ref}/cancelCancel a booking you created.

Check a charter

Charters are sold as the whole aircraft. from and to are free text: a town, airport or lodge airstrip. When both match an airport we know, each aircraft also shows an estimated flight time and distance. Aircraft that cannot take the group or the runway show available: false with a reason.

POST /quote
{
  "product": "charter",
  "from": "Cape Town International (CPT)",
  "to": "Singita Sabi Sand airstrip",
  "date": "2026-12-04",
  "returnDate": null,
  "adults": 2, "children": 0, "infants": 0
}
{ "ok": true, "data": {
  "type": "charter", "from": "Cape Town International (CPT)", "to": "Singita Sabi Sand airstrip",
  "routeKnown": false, "seatsNeeded": 2,
  "options": [
    { "aircraftId": "c182", "aircraft": "Cessna 182", "seats": 3, "available": true, "flightMinutes": null },
    …
  ] } }

No prices are returned. Our reservations team quotes each request.

Create a booking

Send the same fields plus the chosen aircraftId, the lead guest and passengers. Use Idempotency-Key so a retry never creates a second booking.

POST /bookings
Idempotency-Key: TNS-48213-1

{
  "product": "charter", "from": "Cape Town", "to": "Plettenberg Bay", "date": "2026-12-04",
  "adults": 2, "aircraftId": "pa31", "departureTime": "09:30",
  "partnerReference": "TNS-48213",
  "contact": { "name": "Amira Khan", "email": "amira@example.com", "phone": "+971 50 123 4567" },
  "passengers": [ { "name": "Amira Khan" }, { "name": "Omar Khan" } ],
  "notes": "Transfer to Kurland lodge"
}
201 Created
{ "ok": true, "data": { "ref": "AW7K3MQX", "status": "requested",
  "partnerReference": "TNS-48213", … } }

Whale & scenic flights

All African Wings flights are sold as the whole aircraft, never per seat. Scenic flights run at fixed times: check which times are free, then quote or book with the slot and the number of guests.

GET /availability?productId=whale-30&date=2026-11-02

POST /bookings
{ "product": "scenic", "productId": "whale-30", "date": "2026-11-02", "slot": "09:00",
  "adults": 2, "partnerReference": "TNS-50110",
  "contact": { … }, "passengers": [ … ] }

Empty legs use "product": "emptyleg" with the legId from /products.

Booking lifecycle

StatusMeaning
requestedReceived. We are checking aircraft, crew and airfields.
confirmedReserved. The quote and payment terms are in the webhook message.
paidPayment received.
completedFlown.
cancelledCancelled by you or by us.

Webhooks

Give us an HTTPS address and we POST every status change to it. Verify the signature with your webhook secret.

POST https://your-platform.example/hooks/african-wings
X-AW-Event: booking.confirmed
X-AW-Signature: sha256=5f1c…

{ "event": "booking.confirmed", "sentAt": "2026-11-28T10:02:11+02:00",
  "booking": { "ref": "AW7K3MQX", "status": "confirmed", "partnerReference": "TNS-48213", … } }
// Node.js check
const expected = 'sha256=' + crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex');
const valid = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers['x-aw-signature']));

Reply with any 2xx status. You can also poll GET /bookings/{ref}.

Product feed

GET /feed returns every sellable product: popular charter routes per aircraft, scenic flights (whole aircraft), and live empty legs. Each has a stable sku. Use ?format=csv for an extranet upload.

sku,type,name,from,to,date,time,maxGuests,durationMin,priceBasis
CHT-FACT-FAPG-PA31,charter,Private charter Cape Town (CPT) to Plettenberg Bay (PBZ) by Piper PA-31 Navajo,FACT,FAPG,,,6,90,"per aircraft, one way"

Errors & limits

Errors return "ok": false with a code, a readable message and, for validation, a fields map.

HTTPCodeWhen
401unauthorizedMissing or wrong API key.
404not_foundUnknown endpoint, product or booking.
409unavailableAircraft already booked at that time, or empty leg no longer available.
422invalid_requestA field is missing or wrong; see fields.
429rate_limitedMore than 240 requests a minute.

Questions: safari@africanwings.co.za