Create a hotel search
curl --request POST \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches \
--header 'Content-Type: application/json' \
--data '
{
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
}
'import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches"
payload = {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
}
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({
checkInDate: '2026-11-02',
checkOutDate: '2026-11-05',
destinationId: 'sao-paulo-sp',
rooms: [{adults: 2, children: 1}]
})
};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/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}/hotel/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([
'checkInDate' => '2026-11-02',
'checkOutDate' => '2026-11-05',
'destinationId' => 'sao-paulo-sp',
'rooms' => [
[
'adults' => 2,
'children' => 1
]
]
]),
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}/hotel/searches"
payload := strings.NewReader("{\n \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\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}/hotel/searches")
.header("Content-Type", "application/json")
.body("{\n \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/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 \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "srch_Qm8Zt3LwXc1Ry7NvB0kHd",
"searchParams": {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
},
"type": "HOTEL",
"status": "PROCESSING",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"ttl": 1800,
"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": "checkInDate",
"message": "Invalid input: expected string, received undefined",
"code": "CHECKINDATE_REQUIRED"
}
]
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "PROVIDER_UNAVAILABLE",
"origin": "TRAVEL",
"message": "Travel provider temporarily unavailable, please retry."
}Create a hotel search
Starts a search for hotels in a destination, for given dates and rooms.
POST
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
hotel
/
searches
Create a hotel search
curl --request POST \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches \
--header 'Content-Type: application/json' \
--data '
{
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
}
'import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/searches"
payload = {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
}
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({
checkInDate: '2026-11-02',
checkOutDate: '2026-11-05',
destinationId: 'sao-paulo-sp',
rooms: [{adults: 2, children: 1}]
})
};
fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/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}/hotel/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([
'checkInDate' => '2026-11-02',
'checkOutDate' => '2026-11-05',
'destinationId' => 'sao-paulo-sp',
'rooms' => [
[
'adults' => 2,
'children' => 1
]
]
]),
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}/hotel/searches"
payload := strings.NewReader("{\n \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\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}/hotel/searches")
.header("Content-Type", "application/json")
.body("{\n \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/hotel/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 \"checkInDate\": \"2026-11-02\",\n \"checkOutDate\": \"2026-11-05\",\n \"destinationId\": \"sao-paulo-sp\",\n \"rooms\": [\n {\n \"adults\": 2,\n \"children\": 1\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "srch_Qm8Zt3LwXc1Ry7NvB0kHd",
"searchParams": {
"checkInDate": "2026-11-02",
"checkOutDate": "2026-11-05",
"destinationId": "sao-paulo-sp",
"rooms": [
{
"adults": 2,
"children": 1
}
]
},
"type": "HOTEL",
"status": "PROCESSING",
"warning": {
"code": "ALL_SUCCESS",
"message": "All suppliers answered."
},
"ttl": 1800,
"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": "checkInDate",
"message": "Invalid input: expected string, received undefined",
"code": "CHECKINDATE_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 hotel search lasts 30 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 destinationId with the locations endpoint. To book a result, open the item for its rooms, then create a trip with the item’s id as searchItemId and the chosen rooms’ id as roomId.
An error the travel provider reports about the request — an unknown destination, 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
Check-in date (YYYY-MM-DD). Today or later, and before checkOutDate.
Minimum string length:
1Example:
"2026-11-02"
Check-out date (YYYY-MM-DD), after checkInDate.
Minimum string length:
1Example:
"2026-11-05"
Destination: the id or the slug of a place returned by the locations endpoint.
Minimum string length:
1Example:
"sao-paulo-sp"
The rooms to search for, with who stays in each. At least one.
Minimum array length:
1Show child attributes
Show child attributes
Response
Successful response
A search just created for hotels. 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_Qm8Zt3LwXc1Ry7NvB0kHd"
What the search was made for.
Show child attributes
Show child attributes
Always HOTEL.
Available options:
HOTEL Example:
"HOTEL"
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:
1800
Facets to build filters from (star ratings, price ranges). null until the search completes.
Show child attributes
Show child attributes
When the search was created.
Example:
"2026-10-19T15:00:00.000Z"