curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}', 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}/hotel/searches/{searchId}",
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}/hotel/searches/{searchId}"
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}/hotel/searches/{searchId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}")
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_V1StGXR8Z5jdHi6BmyT2k",
"status": "COMPLETED",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"createdAt": "2026-10-19T15:00:00.000Z",
"searchParams": {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
},
"type": "HOTEL",
"ttl": 1500,
"facets": {},
"next": "eyJwIjoyfQ==",
"totalCount": 1,
"items": [
{
"id": "srch_item_Zt5Hk2NwQe8Lr3VcXb1Ya",
"searchId": "srch_Qm8Zt3LwXc1Ry7NvB0kHd",
"hotel": {
"id": "htl_Pd4Mx9TgUa6Rj1WnKc3Sv",
"name": "Hotel Paulista Plaza",
"shortAddress": "Av. Paulista, 1000, Bela Vista, São Paulo, SP",
"starRating": "4",
"mainImageUrl": "https://example.com/hotels/paulista-plaza/main.jpg",
"chain": {
"brandName": "Aurora Express",
"chainName": "Grupo Aurora",
"logo": "https://example.com/logos/aurora.svg"
},
"amenities": [
"WIRELESS_INTERNET_CONNECTION_IN_PUBLIC_AREAS"
]
},
"checkIn": "2026-11-02",
"checkOut": "2026-11-05",
"cheapestFare": {
"fare": {
"originalAmount": 135000,
"discountAmount": 15000,
"feeAmount": 5000,
"amount": 125000,
"currency": "BRL",
"boardType": "BREAKFAST",
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
}
}
}
]
}{
"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": "order",
"message": "Invalid option: expected one of \"ASC\"|\"DESC\"",
"code": "ORDER_ONE_OF"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Get a hotel search and its results
Returns a hotel search and, once it has finished, one page of its hotels.
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}', 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}/hotel/searches/{searchId}",
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}/hotel/searches/{searchId}"
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}/hotel/searches/{searchId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches/{searchId}")
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_V1StGXR8Z5jdHi6BmyT2k",
"status": "COMPLETED",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"createdAt": "2026-10-19T15:00:00.000Z",
"searchParams": {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
},
"type": "HOTEL",
"ttl": 1500,
"facets": {},
"next": "eyJwIjoyfQ==",
"totalCount": 1,
"items": [
{
"id": "srch_item_Zt5Hk2NwQe8Lr3VcXb1Ya",
"searchId": "srch_Qm8Zt3LwXc1Ry7NvB0kHd",
"hotel": {
"id": "htl_Pd4Mx9TgUa6Rj1WnKc3Sv",
"name": "Hotel Paulista Plaza",
"shortAddress": "Av. Paulista, 1000, Bela Vista, São Paulo, SP",
"starRating": "4",
"mainImageUrl": "https://example.com/hotels/paulista-plaza/main.jpg",
"chain": {
"brandName": "Aurora Express",
"chainName": "Grupo Aurora",
"logo": "https://example.com/logos/aurora.svg"
},
"amenities": [
"WIRELESS_INTERNET_CONNECTION_IN_PUBLIC_AREAS"
]
},
"checkIn": "2026-11-02",
"checkOut": "2026-11-05",
"cheapestFare": {
"fare": {
"originalAmount": 135000,
"discountAmount": 15000,
"feeAmount": 5000,
"amount": 125000,
"currency": "BRL",
"boardType": "BREAKFAST",
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
}
}
}
]
}{
"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": "order",
"message": "Invalid option: expected one of \"ASC\"|\"DESC\"",
"code": "ORDER_ONE_OF"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}status is PROCESSING only the search itself comes back, so poll until it is COMPLETED, then read items. A FAILED search has no results. A hotel search expires after its ttl (30 minutes) and then answers 404 SEARCH_NOT_FOUND. Only the organization that created a search can read it.
Results come in pages. Sort them with order and orderBy, narrow them with minAmount, maxAmount, starRating, hotelIds, latitude, longitude and radius, then walk the pages with limit and the next cursor each response returns (null on the last page). A filter that takes several values accepts them repeated or comma-separated (?starRating=4&starRating=5 or ?starRating=4,5). Amounts are integers in cents: 98700 is R$ 987,00.
Each item is a summary with its cheapest fare. To book one, open it with the hotel search item endpoint for everything a trip needs, and create the trip with the item’s id as searchItemId. To place the hotels on a map, read the same search as map points with the map endpoint. An error the travel provider reports about the request — a filter value it does not accept, say — 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 hotel search, as returned when it was created.
^srch_[0-9A-Za-z]{21}$Query Parameters
Sort direction applied to orderBy: ASC lists the cheapest results first, DESC the most expensive first.
ASC, DESC Field to sort the results by. Currently only amount is supported.
1Cursor returned as next by the previous page. Omit for the first page.
1Maximum number of items per page, from 1 to 100.
1 <= x <= 100Only results costing at least this amount, in the same unit as the amount of the results (cents).
x >= 0Only results costing at most this amount, in the same unit as the amount of the results (cents).
x >= 0Only hotels with these star ratings, from 1 to 5.
Example (comma-separated list): ?starRating=4,5
Only these hotels, by ID (hotelId in the results). A hotel that appears more than once in the search keeps all of its items.
Example (comma-separated list): ?hotelIds=htl_Pd4Mx9TgUa6Rj1WnKc3Sv,htl_Ek8Bn2VqLt5Hy7DwXu1Zo
^htl_[0-9A-Za-z]{21}$Latitude of the center of a circle to search in, in decimal degrees (-90 to 90). Send it together with longitude and radius.
Longitude of the center of a circle to search in, in decimal degrees (-180 to 180). Send it together with latitude and radius.
Radius of the circle around latitude and longitude, in meters (1 to 100000). Hotels whose position is unknown are never inside it. Send it together with latitude and longitude.
1 <= x <= 100000Response
Successful response
A hotel search with, once it is COMPLETED, one page of its hotels.
ID of the search.
"srch_V1StGXR8Z5jdHi6BmyT2k"
PROCESSING while the suppliers answer, then COMPLETED or FAILED. Only COMPLETED carries items.
PROCESSING, FAILED, COMPLETED "COMPLETED"
How the search went across the suppliers. null while it is processing.
Show child attributes
Show child attributes
When the search was created.
"2026-10-19T15:00:00.000Z"
What the search was made for, as sent.
Show child attributes
Show child attributes
Always HOTEL.
HOTEL "HOTEL"
Seconds until the search expires (a hotel search lasts 30 minutes).
1500
Facets to build filters from (star ratings, price ranges). null until the search completes.
Show child attributes
Show child attributes
Cursor for the next page. null on the last page. Present only once the search is COMPLETED.
"eyJwIjoyfQ=="
Number of results that match the filters, across every page. Present only once the search is COMPLETED.
1
The hotels of this page, filtered and sorted by the query parameters. Present only once the search is COMPLETED.
Show child attributes
Show child attributes