curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/searches/{searchId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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}/bus/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}/bus/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}/bus/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}/bus/searches/{searchId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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": {
"from": "terminal-rodoviario-tiete",
"to": "rodoviaria-novo-rio",
"departureDate": "2026-11-02",
"returnDate": "2026-11-05",
"serviceClass": "EXECUTIVE"
},
"type": "BUS",
"ttl": 640,
"facets": {},
"next": "eyJwIjoyfQ==",
"totalCount": 1,
"items": [
{
"id": "srch_item_Lc7Ve3PsKd9Ny2QtXw5Mb",
"searchId": "srch_Fg4Ju9SaPe2Wx6TnCi5Oz",
"type": "DIRECT",
"routeDirection": "DEPARTURE",
"origin": {
"id": "bus_sta_Ts5Gm8XqVb2Hw7NcKe1Ld",
"slug": "terminal-rodoviario-tiete",
"locality": "São Paulo",
"administrativeArea": "SP",
"name": "Terminal Rodoviário Tietê",
"shortAddress": "Av. Cruzeiro do Sul, 1800, São Paulo, SP",
"phoneNumbers": [
"+551122222222"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "bus_sta_Ts5Gm8XqVb2Hw7NcKe1Ld",
"slug": "terminal-rodoviario-tiete",
"locality": "São Paulo",
"administrativeArea": "SP",
"name": "Terminal Rodoviário Tietê",
"shortAddress": "Av. Cruzeiro do Sul, 1800, São Paulo, SP",
"phoneNumbers": [
"+551122222222"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"departureDate": "2026-11-02T22:30:00",
"arrivalDate": "2026-11-03T05:15:00",
"company": {
"name": "Viação Aurora",
"logo": "https://example.com/logos/aurora-bus.svg",
"id": "bus_co_Nx3Rp8YtKd5Wc1LqHe7Va"
},
"availableSeats": 18,
"totalSeats": 42,
"lowFareAvailableSeats": 4,
"fare": {
"originalAmount": 21000,
"discountAmount": 2000,
"feeAmount": 1500,
"amount": 20500,
"currency": "BRL",
"isLowFare": false,
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
},
"boardingPassType": "ELECTRONIC",
"serviceClass": "EXECUTIVE",
"waitingTime": "",
"duration": "PT6H45M",
"amenities": [
"AIR_CONDITIONING"
],
"segmentsCount": 1,
"createdAt": "2026-10-19T15:00:21.000Z"
}
]
}{
"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 bus search and its results
Returns a bus search and, once it has finished, one page of its trips.
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/searches/{searchId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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}/bus/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}/bus/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}/bus/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}/bus/searches/{searchId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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": {
"from": "terminal-rodoviario-tiete",
"to": "rodoviaria-novo-rio",
"departureDate": "2026-11-02",
"returnDate": "2026-11-05",
"serviceClass": "EXECUTIVE"
},
"type": "BUS",
"ttl": 640,
"facets": {},
"next": "eyJwIjoyfQ==",
"totalCount": 1,
"items": [
{
"id": "srch_item_Lc7Ve3PsKd9Ny2QtXw5Mb",
"searchId": "srch_Fg4Ju9SaPe2Wx6TnCi5Oz",
"type": "DIRECT",
"routeDirection": "DEPARTURE",
"origin": {
"id": "bus_sta_Ts5Gm8XqVb2Hw7NcKe1Ld",
"slug": "terminal-rodoviario-tiete",
"locality": "São Paulo",
"administrativeArea": "SP",
"name": "Terminal Rodoviário Tietê",
"shortAddress": "Av. Cruzeiro do Sul, 1800, São Paulo, SP",
"phoneNumbers": [
"+551122222222"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"destination": {
"id": "bus_sta_Ts5Gm8XqVb2Hw7NcKe1Ld",
"slug": "terminal-rodoviario-tiete",
"locality": "São Paulo",
"administrativeArea": "SP",
"name": "Terminal Rodoviário Tietê",
"shortAddress": "Av. Cruzeiro do Sul, 1800, São Paulo, SP",
"phoneNumbers": [
"+551122222222"
],
"coordinates": {
"lat": -23.4356,
"lng": -46.4731
}
},
"departureDate": "2026-11-02T22:30:00",
"arrivalDate": "2026-11-03T05:15:00",
"company": {
"name": "Viação Aurora",
"logo": "https://example.com/logos/aurora-bus.svg",
"id": "bus_co_Nx3Rp8YtKd5Wc1LqHe7Va"
},
"availableSeats": 18,
"totalSeats": 42,
"lowFareAvailableSeats": 4,
"fare": {
"originalAmount": 21000,
"discountAmount": 2000,
"feeAmount": 1500,
"amount": 20500,
"currency": "BRL",
"isLowFare": false,
"cancellationPolicies": {
"refundable": true,
"immediateFine": false,
"penalties": [
{
"from": "2026-10-30",
"currency": "BRL",
"fineAmount": 15000
}
]
}
},
"boardingPassType": "ELECTRONIC",
"serviceClass": "EXECUTIVE",
"waitingTime": "",
"duration": "PT6H45M",
"amenities": [
"AIR_CONDITIONING"
],
"segmentsCount": 1,
"createdAt": "2026-10-19T15:00:21.000Z"
}
]
}{
"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 bus search expires after its ttl (15 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, type, serviceClass, company, departureOriginName, departureDestinationName, departureTimePeriod, returnOriginName, returnDestinationName, returnTimePeriod and routeDirection, 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 (?serviceClass=EXECUTIVE&serviceClass=SEMI_BED or ?serviceClass=EXECUTIVE,SEMI_BED). 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 bus search item endpoint for everything a trip needs, and create the trip with the item’s id as searchItemId. 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 bus 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 trips of these types: DIRECT, CONNECTION or ONE_STOP.
Example (comma-separated list): ?type=DIRECT,ONE_STOP
Only these service classes: SLEEPER_BED, BED, SEMI_BED, EXECUTIVE, CONVENTIONAL or UNDEFINED.
Example (comma-separated list): ?serviceClass=EXECUTIVE,SEMI_BED
Only trips run by these bus companies, by name.
Example (comma-separated list): ?company=Viação Aurora,Expresso Litoral
Only outbound trips leaving from these stations, by name.
Example (comma-separated list): ?departureOriginName=Terminal Rodoviário Tietê,Terminal Barra Funda
Only outbound trips arriving at these stations, by name.
Example (comma-separated list): ?departureDestinationName=Rodoviária Novo Rio,Terminal Américo Fontenelle
Only outbound trips leaving in these periods of the day: DAWN, MORNING, AFTERNOON or NIGHT.
Example (comma-separated list): ?departureTimePeriod=MORNING,AFTERNOON
Only return trips leaving from these stations, by name.
Example (comma-separated list): ?returnOriginName=Rodoviária Novo Rio,Terminal Américo Fontenelle
Only return trips arriving at these stations, by name.
Example (comma-separated list): ?returnDestinationName=Terminal Rodoviário Tietê,Terminal Barra Funda
Only return trips leaving in these periods of the day: DAWN, MORNING, AFTERNOON or NIGHT.
Example (comma-separated list): ?returnTimePeriod=NIGHT,DAWN
Only trips in one direction: DEPARTURE (outbound) or RETURN. Omit it to get both.
1Response
Successful response
A bus search with, once it is COMPLETED, one page of its trips.
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 BUS.
BUS "BUS"
Seconds until the search expires (a bus search lasts 15 minutes).
640
Facets to build filters from (companies, service classes, 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 bus trips of this page, filtered and sorted by the query parameters. Present only once the search is COMPLETED.
Show child attributes
Show child attributes