Skip to main content
GET
Search Flight Offers
Search domestic and regional flights directly through Handle’s aggregated flight engine.

Flight Search Flow

1

1. Search Routes

Send GET /api/v1/bill-payment/flights/search specifying origin (e.g. LOS), destination (e.g. ABV), and departureDate (e.g. 2026-10-15).
2

2. Lock Fare

Call POST /api/v1/bill-payment/flights/lock-rate to guarantee fare pricing and hold seat reservations with the airline.
3

3. Issue Ticket

Execute POST /api/v1/bill-payment/purchase with the locked offer ID to debit the user’s account and issue the e-ticket.

Authorizations

Authorization
string
header
default:sk_test_handle_master_key
required

Supply your secret API key (e.g. sk_live_... or sk_test_...) in the Authorization header.

Query Parameters

origin
string
default:LOS
required
destination
string
default:ABV
required
departureDate
string
default:2026-10-15
required

Response

200 - application/json

Available flight itineraries

origin
string
Example:

"LOS"

destination
string
Example:

"ABV"

departureDate
string
Example:

"2026-10-15"

offersCount
integer
Example:

2

offers
object[]