Developer documentation for external agent portals

Purpose

• Verify the API key is active
• Confirm the organization linked to the key
• Inspect scopes and capabilities before integrating

Example Response

{
  "status": "success",
  "data": {
    "integration": {
      "status": "READY",
      "organization": {
        "name": "Motive Solutions",
        "tier": "SILVER"
      }
    },
    "scopes": [
      "B2B_TICKETS_READ",
      "B2B_BOOKINGS_READ",
      "B2B_BOOKINGS_WRITE"
    ]
  }
}

When to use

• Build your sector dropdowns
• Preload route shortcuts on your search page
• Cache safe route options in your own portal

Example Response

{
  "status": "success",
  "count": 2,
  "data": [
    {
      "from": "LHE",
      "to": "DXB",
      "routePath": "LHE-DXB",
      "label": "LHE -> DXB"
    }
  ]
}

When to use

• Build airline filter lists
• Show airline codes and names consistently
• Render approved airline logos in your UI

Example Response

{
  "status": "success",
  "count": 2,
  "data": [
    {
      "id": "default-pf",
      "code": "PF",
      "name": "AirSial",
      "logoUrl": "https://cdn.example.com/airlines/airsial.webp"
    }
  ]
}

Best for

• Group tickets page
• Route-based listing cards
• Airline-filtered fare tables

Example Query

GET /api/b2b/tickets/grouped?subCategoryId=YOUR_SUBCATEGORY_UUID&page=1&pageSize=50

Supported Query Params

• from, to, date
• passengers
• categoryId, subCategoryId, subSubCategoryId
• airline
• minPrice, maxPrice
• lowSeatsOnly
• page, pageSize

Important Notes

• Use groups to render route sections.
• Use rows inside each group for fare rows.
• Provider internals are not exposed.
• SkyPass seat counts are hidden where required by FlyNDeal policy.

Example Response

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "FND-CFA5F676962902EFEA0A4796",
        "type": "LIVE_QUOTE",
        "pnr": null,
        "airlineCode": "9P",
        "airlineName": "FLY JINNAH",
        "flightNo": "764",
        "from": "ISB",
        "to": "BAH",
        "routePath": "ISB-BAH",
        "itineraryType": "ONE_WAY",
        "departureDate": "2026-07-16",
        "departureTime": "21:10",
        "arrivalTime": "22:50:00",
        "seatsAvailable": 7,
        "hideSeats": false,
        "isRefundable": false,
        "sellingPrice": 114000,
        "currency": "PKR",
        "isStale": false
      }
    ],
    "groups": [
      {
        "groupKey": "ISB-BAH__9P",
        "routeKey": "ISB-BAH",
        "from": "ISB",
        "to": "BAH",
        "airlineCode": "9P",
        "airlineName": "FLY JINNAH",
        "summary": {
          "totalRows": 1,
          "minSellingPrice": 114000,
          "maxSellingPrice": 114000,
          "avgSellingPrice": 114000,
          "lowSeatsCount": 0
        },
        "rows": [
          {
            "id": "FND-CFA5F676962902EFEA0A4796",
            "flightNo": "764",
            "departureDate": "2026-07-16",
            "departureTime": "21:10",
            "arrivalTime": "22:50:00",
            "sellingPrice": 114000,
            "currency": "PKR"
          }
        ]
      }
    ],
    "meta": {
      "page": 1,
      "pageSize": 50,
      "returned": 1,
      "returnedGroups": 1,
      "hasNext": false,
      "hasPrev": false
    }
  }
}

Frontend Mapping

• Render one card or section per group.
• Use group.routeKey and group.airlineName in the header.
• Use group.summary for fare count and min/avg price labels.
• Loop over group.rows for the actual table rows.
• Use items only if your portal also needs a flat list view.

Required Body

{
  "from": "LHE",
  "to": "DXB",
  "date": "2026-07-12",
  "passengers": 1
}

Example Response

{
  "status": "success",
  "count": 1,
  "data": [
    {
      "id": "FND-86E34147AC02B960A66B7CAB",
      "airline": {
        "code": "PF",
        "name": "AIR SIAL"
      },
      "flightNo": "PF 786",
      "sector": {
        "from": "LHE",
        "to": "DXB"
      },
      "pricing": {
        "currency": "PKR",
        "total": 82500
      },
      "seatsAvailable": 4
    }
  ]
}

Live Quote Payload

{
  "flightId": "FND-86E34147AC02B960A66B7CAB",
  "passengers": 1,
  "searchContext": {
    "from": "LHE",
    "to": "DXB",
    "date": "2026-07-12"
  }
}

Example Response

{
  "status": "success",
  "data": {
    "available": true,
    "message": "Seats available on verified FlyNDeal fare",
    "seatsAvailable": 7
  }
}

Required Headers

• x-api-key
• idempotency-key

Example Body

{
  "flightId": "FND-86E34147AC02B960A66B7CAB",
  "isUrgent": false,
  "passengers": [
    {
      "title": "MR",
      "passengerType": "ADULT",
      "firstName": "Ali",
      "lastName": "Khan",
      "passportNo": "P1234567",
      "nationality": "PK",
      "dob": "1995-01-01",
      "passportExpiry": "2031-01-01"
    }
  ],
  "searchContext": {
    "from": "LHE",
    "to": "DXB",
    "date": "2026-07-12"
  }
}

Example Response

{
  "status": "success",
  "message": "B2B booking request created successfully",
  "data": {
    "bookingRef": "FND-2E58CF997B4DD234",
    "status": "QUEUED",
    "pnr": "ABC123",
    "pnrConfirmation": null,
    "externalPNR": "ABC123",
    "supplierReference": "ABC123"
  }
}

Path Parameter

• bookingRef: FlyNDeal booking reference

Example Response

{
  "status": "success",
  "data": {
    "bookingRef": "FND-2E58CF997B4DD234",
    "status": "QUEUED",
    "totalAmount": 21000,
    "pnr": "GDS123",
    "pnrConfirmation": null,
    "externalPNR": "GDS123",
    "supplierReference": "GDS123"
  }
}