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.
Getting started
- Email safari@africanwings.co.za to agree commercial terms and commission.
- We send your API key and webhook secret privately.
- Call
GET /pingto check the key, thenGET /productsto 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
| Method | Path | What it does |
|---|---|---|
| GET | /ping | Checks your key and shows your commission. |
| GET | /products | Suggested airports, aircraft, scenic flights and live empty legs. |
| GET | /feed?format=json|csv | Flat product list for an extranet upload. |
| POST | /quote | Check 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 | /bookings | Create a booking request. Supports Idempotency-Key. |
| GET | /bookings/{ref} | Read a booking you created. |
| POST | /bookings/{ref}/cancel | Cancel 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
| Status | Meaning |
|---|---|
requested | Received. We are checking aircraft, crew and airfields. |
confirmed | Reserved. The quote and payment terms are in the webhook message. |
paid | Payment received. |
completed | Flown. |
cancelled | Cancelled 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.
| HTTP | Code | When |
|---|---|---|
| 401 | unauthorized | Missing or wrong API key. |
| 404 | not_found | Unknown endpoint, product or booking. |
| 409 | unavailable | Aircraft already booked at that time, or empty leg no longer available. |
| 422 | invalid_request | A field is missing or wrong; see fields. |
| 429 | rate_limited | More than 240 requests a minute. |
Questions: safari@africanwings.co.za