Postman Collections
The agent collections and development environment are available for easy API testing.
Downloads
| Collection | Description | Download |
|---|---|---|
| Flight Booking for Agents | The complete third-party agent flight workflow | Download |
| Safiri Agent API | Agent registration, authentication, flight booking, tickets, and profile | Download |
| Environment Template | Pre-configured variables for testing | Download |
Collection contents
Flight Bookings
Includes the third-party agent workflow:
- Log in with an agent account
- Fetch airport stops and select valid IATA codes
- Search and save the selected
offer_reference - Review its price, expiry, and booking requirements
- Reserve with traveler and contact details
- Retry separately after an approved price change
- Purchase using
ticket_id - Retrieve the issued tickets
The collection generates future departure and return dates automatically. It does not accept a changed price automatically.
Safiri Agent API
Includes the flight workflow plus third-party agent registration, authentication, generic ticket retrieval, and profile access. It does not include staff-only or operational endpoints.
Environment Variables
The environment template includes these variables:
| Variable | Description |
|---|---|
base_url | API base URL. Defaults to https://booking-api-dev.safiri.app. |
gtfs_flight_url | Airport stop service. Defaults to https://gtfs-flight.safiri.app. |
jwt_token | Your authentication token |
agent_email | Agent account email used by the login request |
agent_password | Agent account password used by the login request |
external_user_id | Your own customer reference |
offer_reference | Selected offer reference saved after search |
reservation_id | Reservation identifier retained for support |
booking_reference | Booking reference supplied to the traveler |
ticket_id | Identifier used for purchase and ticket retrieval |
price_version, price_amount, price_currency | Latest changed-price values saved for the separate approval request |
Import Instructions
- Download the collection you need and the environment file.
- Open Postman and select Import.
- Import both files.
- Select the Safiri API - Development environment.
- Enter the development agent credentials.
- Run the requests in order.
Traveler and document values are sensitive. Use test data in development and do not copy them into shared logs or reports.