Get an air search item
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}', 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/{searchId}/items/{itemId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "srch_item_V1StGXR8Z5jdHi6BmyT2k",
"searchId": "srch_V1StGXR8Z5jdHi6BmyT2k",
"occupants": 1,
"airline": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"journeys": [
{
"id": "jour_Ac9Ld4MsTe6Vn1WqXr8Hu",
"direction": "DEPARTURE",
"origin": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"departureDate": "2026-11-02T08:30:00",
"arrivalDate": "2026-11-02T09:35:00",
"duration": "01:05",
"segments": [
{
"airline": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"operation": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"origin": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"flightNumber": "3300",
"departureDate": "2026-11-02T08:30:00",
"arrivalDate": "2026-11-02T09:35:00",
"flightType": "REGULAR",
"duration": "01:05",
"equipment": "32Q"
}
]
}
],
"fareOptions": [
{
"id": "fare_Jh2Xv8NcQd5Wp1RkTy7Ab",
"description": "LIGHT",
"fare": {
"currency": "BRL",
"originalAmount": 105000,
"discountAmount": 10000,
"feeAmount": 3700,
"amount": 98700,
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
},
"changePolicies": {
"canChange": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
},
"segments": [
{
"flightNumber": "3300",
"cabin": "ECONOMY",
"class": "Y",
"fareBasis": "YLIGHT",
"baggages": [
{
"quantity": 1,
"weight": 10,
"type": "CARRY_ON"
}
]
}
]
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "SEARCH_NOT_FOUND",
"origin": "TRAVEL",
"message": "Search not found"
}{
"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": "organizationId",
"message": "Invalid UUID",
"code": "ORGANIZATIONID_UUID"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Get an air search item
Returns the full detail of one flight of an air search: its journeys and every fare option.
GET
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
air
/
searches
/
{searchId}
/
items
/
{itemId}
Get an air search item
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}', 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/{searchId}/items/{itemId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/air/searches/{searchId}/items/{itemId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "srch_item_V1StGXR8Z5jdHi6BmyT2k",
"searchId": "srch_V1StGXR8Z5jdHi6BmyT2k",
"occupants": 1,
"airline": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"journeys": [
{
"id": "jour_Ac9Ld4MsTe6Vn1WqXr8Hu",
"direction": "DEPARTURE",
"origin": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"departureDate": "2026-11-02T08:30:00",
"arrivalDate": "2026-11-02T09:35:00",
"duration": "01:05",
"segments": [
{
"airline": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"operation": {
"code": "LA",
"name": "LATAM Airlines",
"logo": "https://example.com/logos/la.svg"
},
"origin": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "airpt_Kd3Hq9RwTz5Lx2NvBm8Ys",
"iata": "GRU",
"slug": "sao-paulo-guarulhos-international",
"name": "São Paulo/Guarulhos International Airport",
"shortAddress": "Guarulhos, SP, Brazil",
"locality": "Guarulhos",
"administrativeArea": "SP",
"phoneNumbers": [
"+551133334444"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"flightNumber": "3300",
"departureDate": "2026-11-02T08:30:00",
"arrivalDate": "2026-11-02T09:35:00",
"flightType": "REGULAR",
"duration": "01:05",
"equipment": "32Q"
}
]
}
],
"fareOptions": [
{
"id": "fare_Jh2Xv8NcQd5Wp1RkTy7Ab",
"description": "LIGHT",
"fare": {
"currency": "BRL",
"originalAmount": 105000,
"discountAmount": 10000,
"feeAmount": 3700,
"amount": 98700,
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
},
"changePolicies": {
"canChange": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
},
"segments": [
{
"flightNumber": "3300",
"cabin": "ECONOMY",
"class": "Y",
"fareBasis": "YLIGHT",
"baggages": [
{
"quantity": 1,
"weight": 10,
"type": "CARRY_ON"
}
]
}
]
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "SEARCH_NOT_FOUND",
"origin": "TRAVEL",
"message": "Search not found"
}{
"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": "organizationId",
"message": "Invalid UUID",
"code": "ORGANIZATIONID_UUID"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Open a flight of the search results to see what the list only summarizes: the
journeys and every fare option, each with its cabin and baggage per flight. To book it, create a trip with the item’s id as searchItemId and the chosen fareOptions entry’s id as fareId. Amounts are integers in cents: 98700 is R$ 987,00. The item lives as long as its search (see ttl). An error the travel provider reports about the request is returned with its own status, code and message.Path Parameters
ID of your realm.
Format: UUID
ID of your organization.
Format: UUID
ID of the search, as returned when it was created.
Pattern:
^srch_[0-9A-Za-z]{21}$ID of the item to load, as listed in the items of the search results.
Pattern:
^srch_item_[0-9A-Za-z]{21}$Response
Successful response
The detail of one flight of an air search: its journeys and every fare option.
ID of the item. Send it as searchItemId when you create a trip.
Example:
"srch_item_V1StGXR8Z5jdHi6BmyT2k"
ID of the search the item belongs to.
Example:
"srch_V1StGXR8Z5jdHi6BmyT2k"
Number of travelers the search was made for.
Example:
1
Airline that sells the itinerary.
Show child attributes
Show child attributes
The journeys, in travel order: the outbound first and, for a round trip, the return.
Show child attributes
Show child attributes
Every fare option of the flight, each with its price, rules, cabin and baggage per flight, and ID — send the chosen one's id as fareId when you create a trip.
Show child attributes
Show child attributes