Get a bus search item
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/searches/{searchId}/items/{itemId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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}/bus/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}/bus/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}/bus/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}/bus/searches/{searchId}/items/{itemId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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_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",
"segments": [
{
"id": "seg_Ye6Kt2WnBd9Pq4LsRc1Xv",
"type": "DIRECT",
"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
}
]
}
},
"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,
"lowFareAvailableSeats": 4,
"duration": "PT6H45M",
"serviceClass": "EXECUTIVE",
"seats": [
{
"seatNumber": 12,
"position": {
"x": 2,
"y": 5,
"z": 0
},
"isBookable": true
}
]
}
]
}{
"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 a bus search item
Returns the full detail of one bus trip of a bus search: the trip and its legs, with seat maps and fares.
GET
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
bus
/
searches
/
{searchId}
/
items
/
{itemId}
Get a bus search item
curl --request GET \
--url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/searches/{searchId}/items/{itemId}import requests
url = "https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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}/bus/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}/bus/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}/bus/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}/bus/searches/{searchId}/items/{itemId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/bus/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_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",
"segments": [
{
"id": "seg_Ye6Kt2WnBd9Pq4LsRc1Xv",
"type": "DIRECT",
"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
}
]
}
},
"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,
"lowFareAvailableSeats": 4,
"duration": "PT6H45M",
"serviceClass": "EXECUTIVE",
"seats": [
{
"seatNumber": 12,
"position": {
"x": 2,
"y": 5,
"z": 0
},
"isBookable": true
}
]
}
]
}{
"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 trip of the search results to see what the list only summarizes: its
segments — the legs of the trip — each with its seat map and fare. To book it, create a trip with the item’s id as searchItemId and, for each leg, its id as segmentId with a bookable seat’s seatNumber. 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 bus trip of a bus search: the trip and its legs, with seat maps and fares.
ID of the item. Use it to load the item (seat maps and per-segment fares); send it as searchItemId when you create a trip.
Example:
"srch_item_Lc7Ve3PsKd9Ny2QtXw5Mb"
ID of the search the item belongs to.
Example:
"srch_Fg4Ju9SaPe2Wx6TnCi5Oz"
DIRECT, CONNECTION or ONE_STOP.
Available options:
DIRECT, CONNECTION, ONE_STOP Example:
"DIRECT"
Whether the trip is an outbound (DEPARTURE) or a return (RETURN) one.
Available options:
DEPARTURE, RETURN Example:
"DEPARTURE"
Origin station.
Show child attributes
Show child attributes
Destination station.
Show child attributes
Show child attributes
Departure, in the local time of the origin station (YYYY-MM-DDTHH:mm:ss, no time-zone offset).
Example:
"2026-11-02T22:30:00"
Arrival, in the local time of the destination station (YYYY-MM-DDTHH:mm:ss, no time-zone offset).
Example:
"2026-11-03T05:15:00"
Company that runs the trip.
Show child attributes
Show child attributes
Seats available to book.
Example:
18
Seats on the bus. null when not informed.
Example:
42
Low-fare seats still available. null when not informed.
Example:
4
Fare per passenger.
Show child attributes
Show child attributes
How the boarding pass is delivered: ELECTRONIC or RETRIEVE_AT_BOX_OFFICE.
Available options:
RETRIEVE_AT_BOX_OFFICE, ELECTRONIC Example:
"ELECTRONIC"
SLEEPER_BED, BED, SEMI_BED, EXECUTIVE, CONVENTIONAL or UNDEFINED.
Available options:
SLEEPER_BED, BED, SEMI_BED, EXECUTIVE, CONVENTIONAL, UNDEFINED Example:
"EXECUTIVE"
Wait between connecting legs, as an ISO 8601 duration. Empty for a direct trip.
Example:
""
Duration of the trip, as an ISO 8601 duration.
Example:
"PT6H45M"
Amenities of the bus, as codes: AIR_CONDITIONING, BATHROOM, LEG_SUPPORT, SEAT_RECLINE, BETWEEN_SEATS, BUS_PHOTO, WIFI, POWER_OUTLETS, MINERAL_WATER, DOUBLE_DECK or COMFORT_KIT.
Example: ["AIR_CONDITIONING","WIFI"]
Number of segments the trip is made of: 1 for a direct trip, more with connections.
Example:
1
When the item was created.
Example:
"2026-10-19T15:00:21.000Z"
The legs of the trip, each with its seat map and fare — send each leg's id as segmentId, with a bookable seat's seatNumber, when you create a trip.
Show child attributes
Show child attributes