Skip to content
Football Expeditions
API documentation

Partner API

After signing a partnership contract you get an API key with a dedicated scope. The endpoints below are a preview - the full OpenAPI spec is available to contracted partners after login.

GET
/v1/matches

List matches

All upcoming matches open for sale. Filter by league, date, team.

GET
/v1/matches/:id/availability

Package availability

Sectors, hotels and transfers available for the match, with live pricing.

POST
/v1/inventory/tickets

Upload ticket inventory

Operator-partner adds ticket blocks to their pool. Tickets automatically appear in the package builder.

POST
/v1/inventory/hotels/allotments

Hotel allotments

Room pool tied to a date and match. Supports instant booking and request mode.

POST
/v1/bookings/webhook

Booking webhook

Receive a POST when a customer buys a package containing your inventory. Confirm/cancel/refund events.

In development

The API is in design phase. Endpoints above are a preview of the planned surface - details may shift before v1 ships. Reach out if you want to influence priorities.