> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bilalsadasub.com/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: Bilalsadasub API
  version: 1.0.0
  description: >-
    Bilalsadasub developer API — buy data, airtime, cable, electricity, bulk
    SMS, exam pins, airtime-to-cash and flights, funded from your wallet.
servers:
  - url: https://bilalsadasub.com
    description: Production (live — charges your wallet)
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: List your flight bookings, most recent first.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        reference:
                          type: string
                        pnr:
                          type: string
                          description: Airline PNR (once ticketed)
                        status:
                          type: string
                          description: reserved | ticketed | cancelled | failed
                        trip_type:
                          type: string
                          description: oneway | roundtrip
                        origin:
                          type: string
                        destination:
                          type: string
                        departure_date:
                          type: string
                        return_date:
                          type: string
                        cabin:
                          type: string
                        passengers:
                          type: array
                          items:
                            type: object
                            properties: {}
                        itinerary:
                          type: object
                          properties: {}
                        tickets:
                          type: array
                          items:
                            type: object
                            properties: {}
                        amount:
                          type: number
                        currency:
                          type: string
                        addons_fee:
                          type: number
                        whatsapp_number:
                          type: string
                        reminder_call:
                          type: boolean
                        email_delivery:
                          type: string
                        expires_at:
                          type: string
                          description: Reservation hold expiry (ISO 8601)
                        my_trans_id:
                          type: string
                        created_at:
                          type: string
              example:
                status: success
                data:
                  - reference: FL_1a2b3c
                    pnr: A1B2C3
                    status: ticketed
                    trip_type: oneway
                    origin: LOS
                    destination: ABV
                    departure_date: '2026-12-01'
                    return_date: null
                    cabin: economy
                    passengers:
                      - title: mr
                        first_name: John
                        last_name: Doe
                    itinerary:
                      segments:
                        - from: LOS
                          to: ABV
                          depart: 2026-12-01T08:00
                          airline: P4
                    tickets:
                      - number: '0572101234567'
                        passenger: John Doe
                    amount: 85500
                    currency: NGN
                    addons_fee: 200
                    whatsapp_number: '2348012345678'
                    reminder_call: false
                    email_delivery: account
                    expires_at: '2026-10-22T22:00:00+00:00'
                    my_trans_id: MY-1
                    created_at: '2026-10-22T21:00:00+00: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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.