> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mysubwallet.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# My Flight Bookings

> Lists the flight bookings on **your account only** — scoped to your authenticated user, newest first (up to 50). Use a booking's `reference` to fetch its details, download the ticket, or cancel it. `status` is typically `pending`, `issued`, `cancelled` or `failed`.



## OpenAPI

````yaml GET /api/flight/bookings
openapi: 3.1.0
info:
  title: mySubwallet API
  version: 1.0.0
  description: >-
    Buy data, airtime, cable, electricity, exam pins, bulk SMS, betting, eSIM,
    flights, recharge/data cards and more, funded from your wallet. Test
    everything safely with your sandbox (sk_test_) key — no wallet charge.
servers:
  - url: https://api.mysubwallet.ng
    description: Production (live — charges your wallet)
  - url: https://sandbox.mysubwallet.ng
    description: Sandbox (test — simulated, no wallet charge)
security:
  - TokenAuth: []
tags:
  - name: Purchases
  - name: Verification
  - name: Betting
  - name: eSIM
  - name: Flights
  - name: Wallet
  - name: Catalogs
  - name: Account
paths:
  /api/flight/bookings:
    get:
      tags:
        - Flights
      summary: My Flight Bookings
      description: >-
        Lists the flight bookings on **your account only** — scoped to your
        authenticated user, newest first (up to 50). Use a booking's `reference`
        to fetch its details, download the ticket, or cancel it. `status` is
        typically `pending`, `issued`, `cancelled` or `failed`.
      responses:
        '200':
          description: Your bookings (newest first).
          content:
            application/json:
              example:
                status: success
                data:
                  - reference: FB-7K2M9QZ
                    pnr: A1B2C3
                    status: issued
                    trip_type: one_way
                    origin: LOS
                    destination: ABV
                    departure_date: '2026-07-10'
                    return_date: null
                    cabin: economy
                    passengers:
                      - title: Mr
                        first_name: John
                        last_name: Doe
                        type: adult
                    itinerary:
                      - airline: Air Peace
                        flight_number: P47190
                        departure:
                          airport: LOS
                          time: '2026-07-10T07:30:00'
                        arrival:
                          airport: ABV
                          time: '2026-07-10T08:45:00'
                        duration: 1h 15m
                        cabin: economy
                    tickets:
                      - passenger: John Doe
                        ticket_number: '0632190874321'
                    amount: 78500
                    currency: NGN
                    addons_fee: 0
                    whatsapp_number: '2348012345678'
                    reminder_call: false
                    email_delivery: john@example.com
                    expires_at: '2026-07-10T06:00:00+01:00'
                    my_trans_id: FLT_AB12CD34
                    created_at: '2026-06-25T20:00:00+01:00'
components:
  securitySchemes:
    TokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your API key as `Token <your_api_key>`.


        Use your **live key** for real transactions, or your **sandbox key**
        (`sk_test_…`) to test — sandbox calls return a realistic simulated
        result and never touch your wallet. Add `"sandbox_status": "fail"` to
        any sandbox request to simulate a failure.

````