Create an air search
curl --request POST \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches \
--header 'Content-Type: application/json' \
--data '
{
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": [
"ADULT"
],
"returnDate": "2026-11-05",
"cabin": "ECONOMY"
}
'import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches"
payload = {
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": ["ADULT"],
"returnDate": "2026-11-05",
"cabin": "ECONOMY"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
departureDate: '2026-11-02',
origin: 'GRU',
destination: 'GIG',
passengers: ['ADULT'],
returnDate: '2026-11-05',
cabin: 'ECONOMY'
})
};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'departureDate' => '2026-11-02',
'origin' => 'GRU',
'destination' => 'GIG',
'passengers' => [
'ADULT'
],
'returnDate' => '2026-11-05',
'cabin' => 'ECONOMY'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches"
payload := strings.NewReader("{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches")
.header("Content-Type", "application/json")
.body("{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}"
response = http.request(request)
puts response.read_body{
"id": "srch_V1StGXR8Z5jdHi6BmyT2k",
"searchParams": {
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": [
"ADULT"
],
"cabin": "ECONOMY",
"returnDate": "2026-11-05"
},
"type": "AIR",
"status": "PROCESSING",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"ttl": 900,
"facets": {},
"createdAt": "2026-10-19T15:00:00.000Z"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "TRAVEL",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "departureDate",
"message": "Invalid input: expected string, received undefined",
"code": "DEPARTUREDATE_REQUIRED"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Create an air search
Starts a search for flights, one way or round trip.
POST
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
air
/
searches
Create an air search
curl --request POST \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches \
--header 'Content-Type: application/json' \
--data '
{
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": [
"ADULT"
],
"returnDate": "2026-11-05",
"cabin": "ECONOMY"
}
'import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches"
payload = {
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": ["ADULT"],
"returnDate": "2026-11-05",
"cabin": "ECONOMY"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
departureDate: '2026-11-02',
origin: 'GRU',
destination: 'GIG',
passengers: ['ADULT'],
returnDate: '2026-11-05',
cabin: 'ECONOMY'
})
};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'departureDate' => '2026-11-02',
'origin' => 'GRU',
'destination' => 'GIG',
'passengers' => [
'ADULT'
],
'returnDate' => '2026-11-05',
'cabin' => 'ECONOMY'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches"
payload := strings.NewReader("{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches")
.header("Content-Type", "application/json")
.body("{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"departureDate\": \"2026-11-02\",\n \"origin\": \"GRU\",\n \"destination\": \"GIG\",\n \"passengers\": [\n \"ADULT\"\n ],\n \"returnDate\": \"2026-11-05\",\n \"cabin\": \"ECONOMY\"\n}"
response = http.request(request)
puts response.read_body{
"id": "srch_V1StGXR8Z5jdHi6BmyT2k",
"searchParams": {
"departureDate": "2026-11-02",
"origin": "GRU",
"destination": "GIG",
"passengers": [
"ADULT"
],
"cabin": "ECONOMY",
"returnDate": "2026-11-05"
},
"type": "AIR",
"status": "PROCESSING",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"ttl": 900,
"facets": {},
"createdAt": "2026-10-19T15:00:00.000Z"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "TRAVEL",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "departureDate",
"message": "Invalid input: expected string, received undefined",
"code": "DEPARTUREDATE_REQUIRED"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Searches are asynchronous: this answers
202 at once with the search in PROCESSING status while the travel suppliers answer in the background. Poll the search with its id until status is COMPLETED — or FAILED — to read the results. A flight search lasts 15 minutes (see ttl); after that, create it again. Creating the same search again while it lasts returns the same id, and only your organization can read the searches it created.
Find origin and destination with the locations endpoint. To book a result, open the item for its fares, then create a trip with the item’s id as searchItemId and the chosen fare’s id as fareId.
An error the travel provider reports about the request — an unknown airport, say — is returned with its own status, code and message.Path Parameters
ID of your realm.
Format: UUID
ID of your organization.
Format: UUID
Body
application/json
Outbound flight date (YYYY-MM-DD). Today or later.
Minimum string length:
1Example:
"2026-11-02"
Origin airport: its 3-letter IATA code or its id from the locations endpoint. Must differ from destination.
Minimum string length:
1Example:
"GRU"
Destination airport: its 3-letter IATA code or its id from the locations endpoint. Must differ from origin.
Minimum string length:
1Example:
"GIG"
Who is traveling, one entry per traveler, at least one: ADULT, CHILD, INFANT or SENIOR.
Example: ["ADULT"]
Minimum array length:
1Available options:
ADULT, CHILD, INFANT, SENIOR Return flight date (YYYY-MM-DD), on or after departureDate. Omit it for a one-way trip.
Minimum string length:
1Example:
"2026-11-05"
Cabin to search: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST_CLASS or UNDEFINED. Defaults to ECONOMY.
Minimum string length:
1Example:
"ECONOMY"
Response
Successful response
A search just created for flights. Results come later: poll the search.
ID of the search. The same search parameters, within the time the search lasts, return the same ID.
Example:
"srch_V1StGXR8Z5jdHi6BmyT2k"
What the search was made for.
Show child attributes
Show child attributes
Always AIR.
Available options:
AIR Example:
"AIR"
PROCESSING right after creation. It becomes COMPLETED or FAILED on its own: poll the search.
Available options:
PROCESSING, FAILED, COMPLETED Example:
"PROCESSING"
How the search went across the suppliers. null while it is processing.
Show child attributes
Show child attributes
Seconds until the search expires.
Example:
900
Facets to build filters from (price ranges, airlines). null until the search completes.
Show child attributes
Show child attributes
When the search was created.
Example:
"2026-10-19T15:00:00.000Z"