Cancel a trip

curl --request POST \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/cancel \
  --header 'Content-Type: application/json' \
  --data '
{
  "cancellationQuoteId": "cancel_quote_V1StGXR8Z5jdHi6BmyT2k",
  "sendToManualCancellationOnFail": false
}
'

import requests

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

payload = {
    "cancellationQuoteId": "cancel_quote_V1StGXR8Z5jdHi6BmyT2k",
    "sendToManualCancellationOnFail": False
}
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({
    cancellationQuoteId: 'cancel_quote_V1StGXR8Z5jdHi6BmyT2k',
    sendToManualCancellationOnFail: false
  })
};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/cancel', 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}/cancel",
  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([
    'cancellationQuoteId' => 'cancel_quote_V1StGXR8Z5jdHi6BmyT2k',
    'sendToManualCancellationOnFail' => false
  ]),
  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}/trips/{tripId}/cancel"

	payload := strings.NewReader("{\n  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\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}/trips/{tripId}/cancel")
  .header("Content-Type", "application/json")
  .body("{\n  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\n}"

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"
}

POST

realms

{realmId}

organizations

{organizationId}

trips

{tripId}

cancel

Cancel a trip

curl --request POST \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/cancel \
  --header 'Content-Type: application/json' \
  --data '
{
  "cancellationQuoteId": "cancel_quote_V1StGXR8Z5jdHi6BmyT2k",
  "sendToManualCancellationOnFail": false
}
'

import requests

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

payload = {
    "cancellationQuoteId": "cancel_quote_V1StGXR8Z5jdHi6BmyT2k",
    "sendToManualCancellationOnFail": False
}
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({
    cancellationQuoteId: 'cancel_quote_V1StGXR8Z5jdHi6BmyT2k',
    sendToManualCancellationOnFail: false
  })
};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/cancel', 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}/cancel",
  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([
    'cancellationQuoteId' => 'cancel_quote_V1StGXR8Z5jdHi6BmyT2k',
    'sendToManualCancellationOnFail' => false
  ]),
  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}/trips/{tripId}/cancel"

	payload := strings.NewReader("{\n  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\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}/trips/{tripId}/cancel")
  .header("Content-Type", "application/json")
  .body("{\n  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"cancellationQuoteId\": \"cancel_quote_V1StGXR8Z5jdHi6BmyT2k\",\n  \"sendToManualCancellationOnFail\": false\n}"

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"
}

Send the id of one of the quotes listed for the trip, before it expires. The cancellation runs asynchronously: the answer is 202 Accepted with the trip in PROCESSING_CANCELLATION and the confirmed quote in its cancellation. Read the trip, or its history, to see it become CANCELED. Set sendToManualCancellationOnFail to have a cancellation the travel provider rejects handled manually instead of failing. Visible to an organization admin and to the users the trip carries, like the trip itself.

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 to cancel (24 hexadecimal characters).

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

Body

application/json

cancellationQuoteId

string

required

The id of one of the quotes returned by the cancellation quotes request for this trip (prefix cancel_quote_). A quote can only be confirmed before it expires.

Pattern: ^cancel_quote_[0-9A-Za-z]{21}$

Example:

"cancel_quote_V1StGXR8Z5jdHi6BmyT2k"

sendToManualCancellationOnFail

boolean

When true, a cancellation the travel provider rejects is sent to manual cancellation instead of failing. Defaults to false.

Example:

false

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

Cancel a trip

Path Parameters

Body

Response