> ## 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.

# Book Flight

> Confirm price, debit wallet and issue a ticket. Requires KYC. Auto-refunds on failure.



## OpenAPI

````yaml POST /api/flight/book
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/book:
    post:
      tags:
        - Flights
      summary: Book Flight
      description: >-
        Reserve and pay for a flight offer. Requires completed KYC. Some fares
        require every passenger's travel-document details. Your wallet is
        charged the fare plus any add-on fees. Reuse `my_trans_id` to make
        retries safe.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                flight_id:
                  type: string
                  description: From a Search Flights offer
                my_trans_id:
                  type: string
                  description: >-
                    Unique idempotency key — a retry with the same value returns
                    the original booking
                passengers:
                  type: array
                  items:
                    type: object
                    properties:
                      passenger_type:
                        type: string
                        description: adult | child | infant
                      title:
                        type: string
                        description: mr | mrs | miss | ms
                      first_name:
                        type: string
                      last_name:
                        type: string
                      dob:
                        type: string
                        description: Date of birth YYYY-MM-DD (before today)
                      gender:
                        type: string
                        description: male | female
                      email:
                        type: string
                      phone_number:
                        type: string
                      documents:
                        type: object
                        properties:
                          number:
                            type: string
                            description: Passport/ID number
                          issuing_date:
                            type: string
                            description: YYYY-MM-DD
                          expiry_date:
                            type: string
                            description: YYYY-MM-DD
                          issuing_country:
                            type: string
                            description: 2-letter country code
                          nationality_country:
                            type: string
                            description: 2-letter country code
                    required:
                      - passenger_type
                      - title
                      - first_name
                      - last_name
                      - dob
                      - gender
                      - email
                      - phone_number
                whatsapp_number:
                  type: string
                  description: For WhatsApp ticket delivery (paid add-on)
                reminder_call:
                  type: boolean
                  description: Request a reminder call (paid add-on)
                reminder_phone:
                  type: string
                email_delivery:
                  type: string
                  description: account | custom | each
                email_address:
                  type: string
                  description: Required when email_delivery = custom
              required:
                - flight_id
                - passengers
            example:
              flight_id: OF_abc123
              my_trans_id: MY-1
              passengers:
                - passenger_type: adult
                  title: mr
                  first_name: John
                  last_name: Doe
                  dob: '1990-05-10'
                  gender: male
                  email: john@example.com
                  phone_number: '2348012345678'
                  documents:
                    number: A01234567
                    issuing_date: '2021-01-01'
                    expiry_date: '2031-01-01'
                    issuing_country: NG
                    nationality_country: NG
              email_delivery: account
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    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.