Booking Details - mynztrip

Get Booking Details

GET Endpoint: [BaseUrl]/api/v1/flight-delay-pass/booking-details/{uniqueTransId}

Overview

The Booking Details API retrieves comprehensive information about a flight delay pass booking including passenger details, pass codes, pricing, and current status.

Authentication

This endpoint requires Bearer token authentication. Include your access token in the Authorization header.

URL Parameters

Parameter	Type	Required	Description
uniqueTransId	String	Yes	Unique transaction ID from the booking

Request Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer token for authentication

Example Request

GET [BaseUrl]/api/v1/flight-delay-pass/agent/booking-details/NZFDP2508061933445232

Response

{
  "success": true,
  "uniqueTransId": "NZFDP2508061933445232",
  "code": 200,
  "message": "Booking details retrieved",
  "data": {
    "booking": {
      "unique_trans_id": "NZFDP2508061933445232",
      "product_code": "GMAT60MINS",
      "pnr": "1798061126",
      "pass_codes": [
        "GMAT60MINSABC1400"
      ],
      "passenger_count": 1,
      "passenger_name": "John Doe",
      "passenger_email": "john.doe@example.com",
      "passenger_mobile": "1234567890",
      "passenger_country_code": "+60",
      "booking_total_price": "0.00",
      "currency": "BDT",
      "status": "VOIDED",
      "status_date": "2025-08-06T19:51:11.000000Z",
      "platform_type": "B2B",
      "redeemUrl": "https://fdp.mastercard.com/mynztrip",
      "agent": {
        "company_name": "Agent Malaysia",
        "sl_no": "25080001"
      }
    },
    "pass_codes": [
      "GMAT60MINSABC1400"
    ],
  }
}

Response Fields

Field	Type	Description
success	Boolean	Indicates if the request was successful
uniqueTransId	String	Transaction ID used for the query
code	Integer	HTTP status code
message	String	Response message
data.booking	Object	Main booking information object

Booking Object Fields

Field	Type	Description
unique_trans_id	String	Unique transaction identifier
product_code	String	Product code (e.g., GMAT60MINS)
pnr	String	Passenger Name Record number
pass_codes	Array	Array of issued pass codes
passenger_count	Integer	Number of passengers
passenger_name	String	Full name of passenger
passenger_email	String	Email address
passenger_mobile	String	Mobile number
passenger_country_code	String	Country code for mobile
booking_total_price	Decimal	Total booking amount
original_total_price	Decimal	Original price before any adjustments
total_price_buying	Decimal	Buying price (agent cost)
total_price_selling	Decimal	Selling price (customer price)
conversion_rate	Decimal	Currency conversion rate applied
currency	String	Currency code
status	String	Current booking status
status_date	DateTime	Timestamp of last status change
platform_type	String	Platform type (B2B, B2C)
agent	Object	Agent information

Agent Object Fields

Field	Type	Description
company_name	String	Agent company name
sl_no	String	Agent serial number/ID

Booking Status Values

Status	Description
ISSUED	Pass has been successfully issued and is active
VOIDED	Pass has been cancelled and is no longer valid
PENDING	Pass issuance is in progress
EXPIRED	Pass validity period has expired

Important Notes

Only bookings belonging to the authenticated agent can be retrieved
The api_logs array contains historical API interaction logs (if available)
The pass_codes array in the main data object provides quick access to all pass codes
Price fields show the complete pricing breakdown including buying and selling prices
The status_date indicates when the current status was last updated

Use Cases

This endpoint is useful for:

Verifying booking details after issuance
Customer service inquiries
Reconciliation and reporting
Checking current booking status
Retrieving pass codes for customer communication

Error Responses

Code	Message	Description
404	Booking not found	The uniqueTransId doesn't exist or doesn't belong to the agent
401	Unauthorized	Invalid or expired authentication token
403	Forbidden	Agent doesn't have permission to access this booking

Next Steps

Based on the booking status, you can:

Send Cancel Request if status is ISSUED
Contact support if there are any discrepancies
Use the information for reporting and reconciliation

Issue Pass Cancel Request