Get a trip

curl --request GET \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}

const options = {method: 'GET'};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}', 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}/trips/{tripId}",
  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}/trips/{tripId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}")

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": "6711b4c0d8e1a30012b7c9f2",
  "realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
  "organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
  "createdBy": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
  "customFields": {
    "cost-center": "CC-1020"
  },
  "vertical": "AIR",
  "state": "RESERVED",
  "status": "RESERVED",
  "reservationExpiresAt": "2026-10-02T13:45:12.000Z",
  "originalAmount": 95000,
  "discountAmount": 3010,
  "feeAmount": 0,
  "totalAmount": 91990,
  "currency": "986",
  "passengers": [
    {
      "id": "6710a3f2c9e77b0012a4d5e1",
      "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
      "lead": true,
      "name": "Mariana Costa",
      "gender": "FEMALE",
      "birthDate": "1990-04-17"
    }
  ],
  "productSnapshot": {
    "journeys": [
      {
        "id": "jour_V1StGXR8Z5jdHi6BmyT2k",
        "direction": "DEPARTURE",
        "origin": {
          "iata": "GRU",
          "name": "São Paulo/Guarulhos International Airport",
          "shortAddress": "Guarulhos, SP, Brazil",
          "locality": "Guarulhos",
          "administrativeArea": "SP",
          "phoneNumbers": [
            "551133334444"
          ]
        },
        "destination": {
          "iata": "SDU",
          "name": "Rio de Janeiro/Santos Dumont Airport",
          "shortAddress": "Rio de Janeiro, RJ, Brazil",
          "locality": "Rio de Janeiro",
          "administrativeArea": "RJ",
          "phoneNumbers": [
            "552133339999"
          ]
        },
        "departureDate": "2026-11-02T08:30:00",
        "arrivalDate": "2026-11-02T09:35:00",
        "duration": "01:05",
        "segments": [
          {
            "airline": {
              "code": "LA",
              "name": "LATAM Airlines",
              "logo": "https://cdn.example.com/airlines/LA.png"
            },
            "operation": {
              "code": "LA",
              "name": "LATAM Airlines",
              "logo": "https://cdn.example.com/airlines/LA.png"
            },
            "origin": {
              "iata": "GRU",
              "name": "São Paulo/Guarulhos International Airport",
              "shortAddress": "Guarulhos, SP, Brazil",
              "locality": "Guarulhos",
              "administrativeArea": "SP",
              "phoneNumbers": [
                "551133334444"
              ]
            },
            "destination": {
              "iata": "SDU",
              "name": "Rio de Janeiro/Santos Dumont Airport",
              "shortAddress": "Rio de Janeiro, RJ, Brazil",
              "locality": "Rio de Janeiro",
              "administrativeArea": "RJ",
              "phoneNumbers": [
                "552133339999"
              ]
            },
            "flightNumber": "3101",
            "departureDate": "2026-11-02T08:30:00",
            "arrivalDate": "2026-11-02T09:35:00",
            "flightType": "REGULAR",
            "duration": "01:05",
            "equipment": "32Q",
            "cabin": "ECONOMY",
            "class": "Y",
            "fareBasis": "YOW",
            "flightInfo": null
          }
        ]
      }
    ],
    "tickets": [
      {
        "passengerId": "6710a3f2c9e77b0012a4d5e1",
        "fareDescription": "GRU to SDU, LATAM Airlines, Economy",
        "ticketNumber": null,
        "fares": [
          {
            "journeyId": "jour_V1StGXR8Z5jdHi6BmyT2k",
            "currency": "BRL",
            "originalAmount": 95000,
            "discountAmount": 3010,
            "feeAmount": 0,
            "amount": 91990,
            "cancellationPolicies": {
              "refundable": true,
              "immediateFine": false,
              "penalties": [
                {
                  "from": "2026-10-25",
                  "currency": "BRL",
                  "fineAmount": 15000
                }
              ]
            },
            "changePolicies": {
              "canChange": true,
              "immediateFine": false,
              "penalties": [
                {
                  "from": "2026-10-25",
                  "currency": "BRL",
                  "fineAmount": 8000
                }
              ]
            }
          }
        ],
        "segments": [
          {
            "flightNumber": "3101",
            "cabin": "ECONOMY",
            "class": "Y",
            "fareBasis": "YOW",
            "baggages": [
              {
                "quantity": 1,
                "weight": 23,
                "type": "CHECKED"
              }
            ]
          }
        ]
      }
    ],
    "locators": [
      {
        "type": "PNR",
        "code": "ABC123"
      }
    ],
    "flightInfoUpdatedAt": null
  },
  "createdAt": "2026-10-01T13:45:12.000Z",
  "updatedAt": "2026-10-01T13:46:03.000Z"
}

GET

realms

{realmId}

organizations

{organizationId}

trips

{tripId}

Get a trip

curl --request GET \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}

const options = {method: 'GET'};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}', 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}/trips/{tripId}",
  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}/trips/{tripId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}")

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": "6711b4c0d8e1a30012b7c9f2",
  "realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
  "organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
  "createdBy": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
  "customFields": {
    "cost-center": "CC-1020"
  },
  "vertical": "AIR",
  "state": "RESERVED",
  "status": "RESERVED",
  "reservationExpiresAt": "2026-10-02T13:45:12.000Z",
  "originalAmount": 95000,
  "discountAmount": 3010,
  "feeAmount": 0,
  "totalAmount": 91990,
  "currency": "986",
  "passengers": [
    {
      "id": "6710a3f2c9e77b0012a4d5e1",
      "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
      "lead": true,
      "name": "Mariana Costa",
      "gender": "FEMALE",
      "birthDate": "1990-04-17"
    }
  ],
  "productSnapshot": {
    "journeys": [
      {
        "id": "jour_V1StGXR8Z5jdHi6BmyT2k",
        "direction": "DEPARTURE",
        "origin": {
          "iata": "GRU",
          "name": "São Paulo/Guarulhos International Airport",
          "shortAddress": "Guarulhos, SP, Brazil",
          "locality": "Guarulhos",
          "administrativeArea": "SP",
          "phoneNumbers": [
            "551133334444"
          ]
        },
        "destination": {
          "iata": "SDU",
          "name": "Rio de Janeiro/Santos Dumont Airport",
          "shortAddress": "Rio de Janeiro, RJ, Brazil",
          "locality": "Rio de Janeiro",
          "administrativeArea": "RJ",
          "phoneNumbers": [
            "552133339999"
          ]
        },
        "departureDate": "2026-11-02T08:30:00",
        "arrivalDate": "2026-11-02T09:35:00",
        "duration": "01:05",
        "segments": [
          {
            "airline": {
              "code": "LA",
              "name": "LATAM Airlines",
              "logo": "https://cdn.example.com/airlines/LA.png"
            },
            "operation": {
              "code": "LA",
              "name": "LATAM Airlines",
              "logo": "https://cdn.example.com/airlines/LA.png"
            },
            "origin": {
              "iata": "GRU",
              "name": "São Paulo/Guarulhos International Airport",
              "shortAddress": "Guarulhos, SP, Brazil",
              "locality": "Guarulhos",
              "administrativeArea": "SP",
              "phoneNumbers": [
                "551133334444"
              ]
            },
            "destination": {
              "iata": "SDU",
              "name": "Rio de Janeiro/Santos Dumont Airport",
              "shortAddress": "Rio de Janeiro, RJ, Brazil",
              "locality": "Rio de Janeiro",
              "administrativeArea": "RJ",
              "phoneNumbers": [
                "552133339999"
              ]
            },
            "flightNumber": "3101",
            "departureDate": "2026-11-02T08:30:00",
            "arrivalDate": "2026-11-02T09:35:00",
            "flightType": "REGULAR",
            "duration": "01:05",
            "equipment": "32Q",
            "cabin": "ECONOMY",
            "class": "Y",
            "fareBasis": "YOW",
            "flightInfo": null
          }
        ]
      }
    ],
    "tickets": [
      {
        "passengerId": "6710a3f2c9e77b0012a4d5e1",
        "fareDescription": "GRU to SDU, LATAM Airlines, Economy",
        "ticketNumber": null,
        "fares": [
          {
            "journeyId": "jour_V1StGXR8Z5jdHi6BmyT2k",
            "currency": "BRL",
            "originalAmount": 95000,
            "discountAmount": 3010,
            "feeAmount": 0,
            "amount": 91990,
            "cancellationPolicies": {
              "refundable": true,
              "immediateFine": false,
              "penalties": [
                {
                  "from": "2026-10-25",
                  "currency": "BRL",
                  "fineAmount": 15000
                }
              ]
            },
            "changePolicies": {
              "canChange": true,
              "immediateFine": false,
              "penalties": [
                {
                  "from": "2026-10-25",
                  "currency": "BRL",
                  "fineAmount": 8000
                }
              ]
            }
          }
        ],
        "segments": [
          {
            "flightNumber": "3101",
            "cabin": "ECONOMY",
            "class": "Y",
            "fareBasis": "YOW",
            "baggages": [
              {
                "quantity": 1,
                "weight": 23,
                "type": "CHECKED"
              }
            ]
          }
        ]
      }
    ],
    "locators": [
      {
        "type": "PNR",
        "code": "ABC123"
      }
    ],
    "flightInfoUpdatedAt": null
  },
  "createdAt": "2026-10-01T13:45:12.000Z",
  "updatedAt": "2026-10-01T13:46:03.000Z"
}

An organization admin can read any trip of the organization; a user can read the trips they travel on. Requesting a trip grants no access to it: someone who booked it for others, and is not on it, doesn’t see it. The trip is brought up to date with the travel provider before the answer, so the state you read is current; if the provider can’t be reached you get the last recorded one.

Path Parameters

realmId

string<uuid>

required

ID of your realm.

Format: UUID

organizationId

string<uuid>

required

ID of the organization the trip belongs to.

Format: UUID

tripId

string

required

ID of the trip (24 hexadecimal characters).

Pattern: ^[0-9a-fA-F]{24}$

Response

Successful response

A trip: ONE booked product — a flight, a hotel stay, a bus ticket or a vehicle rental — for the organization's passengers, with its lifecycle. Booking several products means creating several trips.

string

required

ID of the trip.

Example:

"6711b4c0d8e1a30012b7c9f2"

realmId

string<uuid>

required

ID of the realm the trip belongs to.

Example:

"f495ff0c-ab54-4f99-8e92-ca8682e4de9b"

organizationId

string<uuid>

required

ID of the organization the trip belongs to.

Example:

"c4bd3f21-dfbd-44e8-8055-68ba15bed410"

customFields

object

required

Values of the organization's trip custom fields, keyed by the custom field's slug. Empty when none were set.

Example: {"cost-center":"CC-1020"}

Show child attributes

Example:

{ "cost-center": "CC-1020" }

vertical

enum<string>

required

Type of product booked. It tells which shape productSnapshot has.

Available options:

AIR,

HOTEL,

BUS,

VEHICLE

Example:

"AIR"

state

enum<string>

required

Where the booking is in its life: PENDING while the reservation is being made, RESERVED once held (until reservationExpiresAt), ISSUED once ticketed and CANCELED. It only moves forward.

Available options:

PENDING,

RESERVED,

ISSUED,

CANCELED

Example:

"RESERVED"

status

enum<string>

required

Finer-grained status: it also reports work in progress (PROCESSING_*) and failures, and can change back and forth. Use state to decide what the booking is; use status to tell what is happening to it.

Available options:

PROCESSING_RESERVATION,

RESERVATION_FAILED,

RESERVED,

PROCESSING_ISSUE,

ISSUED,

PROCESSING_CANCELLATION,

CANCELED,

AWAITING_MANUAL_CANCELLATION,

CANCELLATION_FAILED,

FAILED,

FAILED_BY_INCONSISTENT_DATA,

FAILED_BY_UNAVAILABLE_RESOURCE,

FAILED_BY_BUDGET_EXCEEDED,

EXPIRED,

BLOCKED,

UNKNOWN,

ISSUANCE_FAILED

Example:

"RESERVED"

passengers

object[]

required

The passengers booked on the trip.

Show child attributes

createdBy

string<uuid>

ID of the user who created the trip. Omitted when a service did.

Example:

"e3553bc1-5e20-4e17-b22a-a796fda0aa99"

reservationExpiresAt

string<date-time> | null

Until when the reservation is held. Past it, a trip that was not issued expires. null or omitted when there is no hold.

Example:

"2026-10-02T13:45:12.000Z"

issuedAt

string<date-time> | null

When the trip was issued. null or omitted until it is.

originalAmount

number

Price before discounts, in cents. Omitted until the price is known.

Example:

95000

discountAmount

number

Discount applied, in cents. Omitted until the price is known.

Example:

3010

feeAmount

number

Fees added, in cents. Omitted until the price is known.

Example:

0

totalAmount

number

Amount to pay, in cents: originalAmount - discountAmount + feeAmount. Omitted until the price is known.

Example:

91990

currency

string

Currency of the amounts, as the numeric ISO 4217 code (986 is BRL).

Example:

"986"

productSnapshot

Air trip · object

The booked product: the itinerary, stay, ticket or rental as recorded by the travel provider — journeys and flights, the hotel and its rooms, the route and boarding information, the rental — with its fares, policies and booking locators. It does not repeat the trip's own fields (state, status, the amounts, the dates) and carries no identifier of the travel provider; passengers are referenced by their id in passengers[]. Its shape depends on vertical: a flight (AIR), a hotel stay (HOTEL), a bus ticket (BUS) or a vehicle rental (VEHICLE) — see the four schemas below. Omitted until the record is first fetched.

Air trip
Hotel trip
Bus trip
Vehicle trip

Show child attributes

cancellation

object

The confirmed cancellation. Omitted until one is confirmed.

Show child attributes

createdAt

string<date-time>

When the trip was created.

Example:

"2026-10-01T13:45:12.000Z"

updatedAt

string<date-time>

When the trip last changed.

Example:

"2026-10-01T13:46:03.000Z"

Overview

Identity

Banking

Billing

Accounting

Registry

Platform

Notification

Rule Engine

Scheduling

Travel

Vehicles

Attachments

Get a trip

Path Parameters

Response