API Reference

Create a new booking component

post
https://secure.mintpayments.com/mpay/v5/bookings//components

Add a new component to an existing booking

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier for the booking

Body Params

Create request for flight booking components including airline tickets with departure/arrival details and passenger information.

string
enum
required

Component type identifier for flight bookings

Allowed:
string
required

Human-readable component name for customer display.

Should be descriptive and customer-friendly, suitable for use in
booking confirmations, itineraries, and customer communications.

string

Detailed component description providing additional context.

Can include specific details about the service, amenities, inclusions,
or other relevant information for the customer.

string
required

Component cost with required decimal precision (2 decimal places).

This represents the total price for this component,
including any taxes, fees, or surcharges.

string
required

Currency code (ISO 4217) for the component amount.

Three-letter currency code following international standards.

string

External supplier booking reference or confirmation number.

Used for communication with suppliers and for tracking
the component booking in external systems.

string

External agent booking reference or confirmation number.

Used when bookings are made through travel agents or
third-party booking platforms.

metadata
object

Additional metadata as key-value pairs for component-specific information.

Can store any additional data relevant to the component that doesn't
fit into the standard request structure.

string
required

IATA airport code for departure airport.

Three-letter airport code following international aviation standards.

string
required

IATA airport code for arrival airport.

Three-letter airport code following international aviation standards.

date-time
required

Scheduled departure date and time (UTC).

The planned departure time according to the airline schedule.

date-time
required

Scheduled arrival date and time (UTC).

The planned arrival time according to the airline schedule.

string
required

Airline flight number for the specific flight.

Includes airline code and flight number (e.g., BA123, LH456).

string
required

IATA airline code for the operating carrier.

Two-letter airline code following international aviation standards.

integer
required
1 to 20

Number of passengers on this flight booking.

Total number of travelers included in this flight component.

Responses

Updated 6 months ago

Language
Credentials
Bearer
UUID
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago