{"info":{"_postman_id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","name":"Al Haider Travel","description":"

Welcome to the Al Haider Travel Documentation. This API provides a structured and efficient way to interact with our system, offering endpoints for accessing and managing relevant data securely and reliably.

Key Features:

Secure authentication and authorization
\n
Efficient data retrieval and management
\n
Well-structured RESTful endpoints
\n
Real-time data updates (if applicable)
\n
Comprehensive error handling and response messages
\n

Usage:

Developers can integrate this API into their applications to access necessary data and automate workflows seamlessly. Each endpoint is documented with request/response examples, parameters, and possible error codes to ensure smooth integration.

For detailed endpoint references, authentication methods, and usage guidelines, explore the sections below.

API Base URL

https://alhaidertravel.pk

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7529188","collectionId":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","publishedId":"2sAYdioVWw","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-03T18:43:42.000Z"},"item":[{"name":"Login","event":[{"listen":"test","script":{"id":"a5bf8f44-0f0d-44fd-bd69-348c07e9bed3","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"feab022f-bcb1-47eb-a022-72e65ac96611","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"email","value":"","type":"text"},{"key":"password","value":"","type":"text"}]},"url":"/api/login","description":"\n

This API endpoint allows users to log in to the application by sending a POST request to the specified URL.

Request

The request should include the following parameters in the request body:

email (string, required): The email address of the user.
\n
password (string, required): The password of the user.
\n

Example request body:

{\n  \"email\": \"user_email@example.com\",\n  \"password\": \"user_password\"\n}\n\n

Response

The API will respond with a JSON object containing the following properties:

token (string): A token for the authenticated user.

Example response body:

{\n  \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9\"\n}\n\n

Request

The request should include the following parameters in the request body:

username (string, required): The username of the user.
\n
password (string, required): The password of the user.
\n

Example request body:

{\n  \"username\": \"example_user\",\n  \"password\": \"example_password\"\n}\n\n

Response

The API will respond with a JSON object containing the following properties:

status (string): The status of the login request. Possible values are \"success\" or \"error\".
\n
message (string): A message providing additional information about the login request.
\n

Example response body for a successful login:

{\n  \"success\": true,\n  \"message\": \"Login successful\"\n}\n\n

Example response body for a failed login:

{\n  \"error\": true,\n  \"message\": \"Invalid username or password\"\n}\n\n

Please note that the actual response may contain additional properties not mentioned here.

\n","urlObject":{"path":["api","login"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"feab022f-bcb1-47eb-a022-72e65ac96611"},{"name":"Get Profile","id":"82f917d1-8ad3-4692-bad1-25e54f1f163a","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"/api/user","description":"

This endpoint makes an HTTP GET request to retrieve user information from the API. The request does not require any payload in the request body. Upon a successful execution, the API returns a status code of 200 along with the user details in the response body.

Response

id (integer): The unique identifier of the user.
\n
name (string): The name of the user.
\n
email (string): The email address of the user.
\n
email_verified_at (string): The timestamp when the user's email was verified.
\n
mobile_no (string): The mobile number of the user.
\n
city (string): The city of the user.
\n

Example Response

{\n    \"id\": 3,\n    \"name\": \"developer\",\n    \"email\": \"developer@alhaidertravel.pk\",\n    \"email_verified_at\": \"2022-06-26T08:08:37.000000Z\",\n    \"mobile_no\": \"03007945433\",\n    \"city\": \"Faisalabad\"\n}\n\n

This HTTP GET request is used to retrieve the list of available sectors. The request does not require a request body. The response will include a list of sectors available for travel, with each sector represented as a string value within the \"sectors\" array. The status of the response will be 200 indicating a successful request.

Example response:

{\n    \"sectors\": [\n        \"FAISALABAD TO ABU DHABI\",\n        \"FAISALABAD TO DUBAI\",\n        \"FAISALABAD TO JEDDAH\",\n        ...\n    ]\n}\n\n

This endpoint makes an HTTP GET request to retrieve the available airlines from the API. The request does not require a request body.

Response

Status: 200
\n

Body:

  {\n      \"airlines\": [\n          {\n              \"id\": 0,\n              \"airline_name\": \"\",\n              \"short_name\": \"\",\n              \"logo_url\": null\n          }\n      ]\n  }\n\n

The response contains an array of airlines, where each airline object includes an ID, airline name, short name, and logo URL.\n\n

","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","name":"Al Haider Travel","type":"collection"}},"urlObject":{"path":["api","available","airlines"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"31af2050-615f-4474-a96f-b88a228f68ae"},{"name":"Check Available Seats","id":"3925ba10-d846-4d72-a169-59d34a2885a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"/api/available/seats/1073","description":"

This endpoint makes an HTTP GET request to retrieve the number of available seats for a specific group with ID 1959. The response will include the group ID and the number of available seats.

Response

seats: An integer representing the number of available seats for the group.

Example

{\n    \"group_id\": \"1959\",\n    \"seats\": 27\n}\n\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","name":"Al Haider Travel","type":"collection"}},"urlObject":{"path":["api","available","seats","1073"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"4242238e-17f3-4589-8ae2-9c1e9d960622","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"/api/available/seats/1073"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 20 Mar 2025 21:48:51 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"29"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"PHP/8.2.27"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"59"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-turbo-charged-by","value":"LiteSpeed"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=OHCAlzXMQ1NkNCyaY4Nk0a8FyMeOX7zOTyQgG7bCjzVbssUO8JxyjJ6NUxjbDgrwA6dqiiE%2B8KjMpNRhdtLlebld%2B8VCeAUHK5tYVGVXLr3f3w0y1qp2zpFoE7Pi3leNb%2FLA8Q%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"92386a837c39d797-NRT"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=190993&min_rtt=173962&rtt_var=63524&sent=34&recv=30&lost=0&retrans=0&sent_bytes=7960&recv_bytes=2997&delivery_rate=37650&cwnd=247&unsent_bytes=0&cid=e2d789baea261634&ts=25740&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"group_id\": \"1073\",\n \"seats\": 5\n}"}],"_postman_id":"3925ba10-d846-4d72-a169-59d34a2885a7"},{"name":"Get Groups","id":"6a7ae026-c9ed-48ee-a639-9044794f664a","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"/api/available/groups?type&airline_id§or=&dept_date","description":"

This endpoint retrieves available groups based on the specified parameters.

Request

Method: GET
\n
URL: /api/available/groups
\n
Query Parameters:
\n
- type (optional) (e.g. UAE)
  \n
- airline_id (optional)
  \n
- sector (e.g. ISLAMABAD)
  \n
- dept_date (optional)
  \n
\n

Response

Status: 200 OK
\n

Body:

  {\n      \"groups\": [\n          {\n              \"id\": 0,\n              \"airline_id\": \"\",\n              \"dept_date\": \"\",\n              \"arv_date\": null,\n              \"sector\": \"\",\n              \"type\": \"\",\n              \"price\": \"\",\n              \"baggage\": \"\",\n              \"meal\": \"\",\n              \"pnr\": \"\",\n              \"entry_date\": \"\",\n              \"details\": [\n                  {\n                      \"id\": 0,\n                      \"group_id\": \"\",\n                      \"sr\": \"\",\n                      \"flight_no\": \"\",\n                      \"flight_date\": \"\",\n                      \"origin\": \"\",\n                      \"destination\": \"\",\n                      \"seats\": \"\",\n                      \"dept_time\": \"\",\n                      \"arv_time\": \"\"\n                  }\n              ]\n          }\n      ]\n  }\n\n

This endpoint returns a JSON array of available groups with their details, based on the provided query parameters.

Get Group Detail

This endpoint retrieves the details of a specific group identified by its ID.

Request

HTTP Request Method

GET

URL

/api/group/detail/1956

Response

Status: 200 OK
Body:

{\n    \"group\": {\n        \"id\": 1956,\n        \"airline_id\": \"21\",\n        \"dept_date\": \"2024-01-13\",\n        \"arv_date\": null,\n        \"sector\": \"ISLAMABAD TO RIYADH\",\n        \"type\": \"KSA ONEWAY\",\n        \"price\": \"106000\",\n        \"baggage\": \"50+7\",\n        \"meal\": \"YES\",\n        \"pnr\": \"I7678B\",\n        \"entry_date\": \"2023-11-03\",\n        \"details\": [\n            {\n                \"id\": 27924,\n                \"group_id\": \"1956\",\n                \"sr\": \"1\",\n                \"flight_no\": \"ER 807\",\n                \"flight_date\": \"2024-01-13\",\n                \"origin\": \"ISB\",\n                \"destination\": \"RUH\",\n                \"seats\": \"10\",\n                \"dept_time\": \"10:10:00\",\n                \"arv_time\": \"12:40:00\"\n            }\n        ],\n        \"airline\": {\n            \"id\": 21,\n            \"airline_name\": \"10. SERENE AIR ISB-RUH\",\n            \"short_name\": \"ER\",\n            \"logo_url\": null\n        }\n    }\n}\n\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","id":"6dd2bef1-44f6-4334-8aa0-638cfe2e18aa","name":"Al Haider Travel","type":"collection"}},"urlObject":{"path":["api","group","detail","1030"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"9a2f817a-887d-4e61-96da-7dbe85e0d248"},{"name":"Create Booking","id":"987d4b01-05e9-4ca5-b8e4-2b05bdf3ce4a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"group_id\": 1030,\r\n \"agency_info\": {\r\n \"group_id\": 1030,\r\n \"agent_name\" : \"Arslan Khalid\",\r\n \"agency_name\" : \"Upheld Travels\",\r\n \"email\" : \"upheldtravels@gmail.com\",\r\n \"mobile\" : \"03001232412\",\r\n \"adults\": 1,\r\n \"child\": 1,\r\n \"infant\": 1,\r\n \"agent_notes\": null\r\n },\r\n \"booking_details\": [\r\n {\r\n \"type\": \"Adult\",\r\n \"surname\": \"Bashir\",\r\n \"given_name\": \"Ali\",\r\n \"title\": \"MR\", // MR, MRS, MS, 'CHD', 'INF'\r\n \"passport_no\": \"FP4141751\",\r\n \"dob\": \"1993-07-07\",\r\n \"doe\": \"2033-06-09\"\r\n },\r\n {\r\n \"type\": \"Child\",\r\n \"surname\": \"Muhammad\",\r\n \"given_name\": \"Ali\",\r\n \"title\": \"CHD\", // MR, MRS, MS, 'CHD', 'INF'\r\n \"passport_no\": \"FP4141752\",\r\n \"dob\": \"1993-07-07\",\r\n \"doe\": \"2033-06-09\"\r\n },\r\n {\r\n \"type\": \"Infant\",\r\n \"surname\": \"Muhammad\",\r\n \"given_name\": \"Musa\",\r\n \"title\": \"INF\", // MR, MRS, MS, 'CHD', 'INF'\r\n \"passport_no\": \"FP4141752\",\r\n \"dob\": \"1993-07-07\",\r\n \"doe\": \"2033-06-09\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"/api/create/booking","description":"

This API endpoint allows you to create a new booking by sending an HTTP POST request to the specified URL.

Request

The request should include the following parameters:

base_url: The base URL of the API.

Response

The response will include the following information:

status: The status of the request, indicating whether the booking was successfully created.
booking_id: The unique identifier for the newly created booking.

Please note that the specific values for the request parameters and the response may vary depending on the implementation of the API.

Example

POST /api/create/booking\n\n

In this example, you would replace with the actual base URL of the API.

Retrieve Booking Details

This API endpoint retrieves the details of a specific booking by providing the booking ID.

To retrieve the details of a booking, make a GET request to the following endpoint: /api/show/booking/14321, where 14321 is the ID of the booking you want to retrieve.

Response:
The response will be a JSON object following this schema:

{\n    \"id\": \"integer\",\n    \"group_id\": \"integer\",\n    \"agency_id\": \"integer\",\n    \"agency_name\": \"string\",\n    \"agent_name\": \"string\",\n    \"email\": \"string\",\n    \"mobile\": \"string\",\n    \"adults\": \"integer\",\n    \"child\": \"integer\",\n    \"infant\": \"integer\",\n    \"cancel_adult\": \"integer\",\n    \"cancel_child\": \"integer\",\n    \"fares\": \"string\",\n    \"agent_notes\": \"string\",\n    \"admin_notes\": \"string\",\n    \"follower_admin_id\": \"integer\",\n    \"created_by_id\": \"integer\",\n    \"status\": \"integer\",\n    \"auto_cancel_after\": \"string\",\n    \"sold_at\": \"string\",\n    \"refunded_at\": \"string\",\n    \"canceled_at\": \"string\",\n    \"created_at\": \"string\",\n    \"updated_at\": \"string\",\n    \"deleted_at\": \"string\",\n    \"passengers\": [\n        {\n            \"id\": \"integer\",\n            \"booking_id\": \"integer\",\n            \"type\": \"string\",\n            \"surname\": \"string\",\n            \"given_name\": \"string\",\n            \"title\": \"string\",\n            \"passport_no\": \"string\",\n            \"dob\": \"string\",\n            \"doe\": \"string\",\n            \"fare\": \"string\",\n            \"status\": \"integer\",\n            \"refunded_at\": \"string\",\n            \"canceled_at\": \"string\",\n            \"created_at\": \"string\",\n            \"updated_at\": \"string\",\n            \"deleted_at\": \"string\",\n            \"name\": \"string\"\n        }\n    ],\n    \"created_by\": {\n        \"id\": \"integer\",\n        \"name\": \"string\",\n        \"email\": \"string\",\n        \"mobile_no\": \"string\",\n        \"add_team_members\": \"boolean\"\n    },\n    \"booking_details\": [\n        {\n            \"id\": \"integer\",\n            \"booking_id\": \"integer\",\n            \"type\": \"string\",\n            \"surname\": \"string\",\n            \"given_name\": \"string\",\n            \"title\": \"string\",\n            \"passport_no\": \"string\",\n            \"dob\": \"string\",\n            \"doe\": \"string\",\n            \"fare\": \"string\",\n            \"status\": \"integer\",\n            \"refunded_at\": \"string\",\n            \"canceled_at\": \"string\",\n            \"created_at\": \"string\",\n            \"updated_at\": \"string\",\n            \"deleted_at\": \"string\",\n            \"name\": \"string\"\n        }\n    ]\n}\n\n

Please note that the response may contain additional fields not mentioned here, but they can be ignored.

Cancel Booking

This API endpoint will cancel the specific booking by providing the booking ID.

Response:
The response will be a JSON object following this schema:

{\n  \"sucess\": true,\n  \"message\": \"Booking have been canceled successfully.\",\n  \"data\": {\n     \"booking_id\": 14321,\n     \"status\": 3,\n     \"canceled_at\": now(),\n  }\n}\n\n

Please note that the response may contain additional fields not mentioned here, but they can be ignored.

Confirm Booking

This API endpoint will confirm the specific booking by providing the booking ID.

Response:
The response will be a JSON object following this schema:

{\n  \"sucess\": true,\n  \"message\": \"Booking have been confirmed successfully.\",\n  \"data\": {\n     \"booking_id\": 14321,\n     \"status\": 3,\n     \"sold_at\": now(),\n  }\n}\n\n\n

Please note that the response may contain additional fields not mentioned here, but they can be ignored.

Key Features:

Usage:

API Base URL

API Request to Login

Request

Response

Request

Response

Response

Example Response

Response

Response

Example

Request

Response

Get Group Detail

Request

HTTP Request Method

URL

Response

Request

Response

Example

Retrieve Booking Details

Cancel Booking

Confirm Booking