Send a trip for approval

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

const options = {method: 'POST'};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/request', 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}/request",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$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}/request"

	req, _ := http.NewRequest("POST", 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}/request")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.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",
  "approval": {
    "status": "REQUESTED",
    "policyRequestId": "b7f1c0d2-4e3a-4f8b-9c21-7a6d5e4f3b2a",
    "failureCode": "RESERVATION_ENDED"
  },
  "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",
  "policy": {
    "id": "3c9e5a17-8d24-4b6f-a0e1-52f7c1d8b9a3",
    "name": "Flights above R$ 1,000.00",
    "actions": {
      "autoAction": "NONE",
      "hierarchy": false,
      "approvals": [
        {
          "type": "USER",
          "id": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
          "name": "Carlos Andrade"
        }
      ]
    },
    "error": "POLICY_EVALUATION_UNAVAILABLE"
  },
  "policyRequest": {
    "id": "b7f1c0d2-4e3a-4f8b-9c21-7a6d5e4f3b2a",
    "status": "REQUESTED",
    "resolution": "AUTO",
    "policyId": "3c9e5a17-8d24-4b6f-a0e1-52f7c1d8b9a3",
    "requester": {
      "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
      "name": "Rafael Lima",
      "email": "rafael.lima@example.com"
    },
    "approvalHierarchy": false,
    "approvals": [
      {
        "type": "USER",
        "id": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
        "name": "Carlos Andrade",
        "status": "REQUESTED",
        "users": [
          {
            "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
            "userName": "Carlos Andrade",
            "userEmail": "carlos.andrade@example.com",
            "status": "REQUESTED"
          }
        ],
        "requestedAt": "2026-10-01T13:46:10.000Z",
        "decisionReason": "Within the travel budget"
      }
    ],
    "denialReason": "Over the monthly budget",
    "approvalDeadline": "2026-10-02T12:30:00.000Z",
    "createdAt": "2026-10-01T13:46:10.000Z",
    "updatedAt": "2026-10-01T14:02:31.000Z",
    "error": "POLICY_REQUEST_UNAVAILABLE"
  }
}

POST

realms

{realmId}

organizations

{organizationId}

trips

{tripId}

request

Send a trip for approval

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

const options = {method: 'POST'};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips/{tripId}/request', 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}/request",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$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}/request"

	req, _ := http.NewRequest("POST", 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}/request")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.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",
  "approval": {
    "status": "REQUESTED",
    "policyRequestId": "b7f1c0d2-4e3a-4f8b-9c21-7a6d5e4f3b2a",
    "failureCode": "RESERVATION_ENDED"
  },
  "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",
  "policy": {
    "id": "3c9e5a17-8d24-4b6f-a0e1-52f7c1d8b9a3",
    "name": "Flights above R$ 1,000.00",
    "actions": {
      "autoAction": "NONE",
      "hierarchy": false,
      "approvals": [
        {
          "type": "USER",
          "id": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
          "name": "Carlos Andrade"
        }
      ]
    },
    "error": "POLICY_EVALUATION_UNAVAILABLE"
  },
  "policyRequest": {
    "id": "b7f1c0d2-4e3a-4f8b-9c21-7a6d5e4f3b2a",
    "status": "REQUESTED",
    "resolution": "AUTO",
    "policyId": "3c9e5a17-8d24-4b6f-a0e1-52f7c1d8b9a3",
    "requester": {
      "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
      "name": "Rafael Lima",
      "email": "rafael.lima@example.com"
    },
    "approvalHierarchy": false,
    "approvals": [
      {
        "type": "USER",
        "id": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
        "name": "Carlos Andrade",
        "status": "REQUESTED",
        "users": [
          {
            "userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
            "userName": "Carlos Andrade",
            "userEmail": "carlos.andrade@example.com",
            "status": "REQUESTED"
          }
        ],
        "requestedAt": "2026-10-01T13:46:10.000Z",
        "decisionReason": "Within the travel budget"
      }
    ],
    "denialReason": "Over the monthly budget",
    "approvalDeadline": "2026-10-02T12:30:00.000Z",
    "createdAt": "2026-10-01T13:46:10.000Z",
    "updatedAt": "2026-10-01T14:02:31.000Z",
    "error": "POLICY_REQUEST_UNAVAILABLE"
  }
}

The organization’s business policies decide what happens next. When a policy requires approvals, the answer is 202 Accepted with the trip in status REQUESTED and the approval request in policyRequest: the approvers decide it, and an approved trip is issued automatically. When no policy requires an approval, the trip is issued right away and the answer is 202 Accepted once the issuance was accepted. Read the trip to follow it. Only flight and bus trips can be sent for approval. The trip must still be reserved, with its booking details loaded and enough time left on the reservation for the approvals to finish: the approval has to be decided at the latest 2 minutes before the reservation expires, and at least a minute of that window must be left when the trip is sent. Sending a trip that is already waiting for approval answers with it as it is. Visible to an organization admin, to the users the trip carries and to the user who booked it, 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 (24 hexadecimal characters).

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

Response

Successful response

A trip with what the organization's business policies say about it: the advisory policy while it can still be sent for approval, and the policyRequest once an approval request exists.

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. While the booking is RESERVED it also tells where the approval is: REQUESTED while the trip waits for its approvers and DENIED once they refused it (approval has the details). Once the booking moves on, its own status shows again.

Available options:

REQUESTED,

DENIED,

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"

approval

object

The latest approval attempt. Omitted until the trip is sent for approval or issued.

Show child attributes

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"

policy

object

What the organization's policies decide for the trip now. Present while the trip is reserved and can be sent for approval or issued; omitted otherwise.

Show child attributes

policyRequest

object

The approval request of the latest attempt. Omitted until one exists.

Show child attributes

Overview

Identity

Banking

Billing

Accounting

Registry

Platform

Notification

Rule Engine

Scheduling

Travel

Vehicles

Attachments

Send a trip for approval

Path Parameters

Response