Create a trip

curl --request POST \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips \
  --header 'Content-Type: application/json' \
  --data '
{
  "customFields": {
    "cost-center": "CC-1020"
  }
}
'

import requests

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

payload = { "customFields": { "cost-center": "CC-1020" } }
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({customFields: {'cost-center': 'CC-1020'}})
};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips', 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",
  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([
    'customFields' => [
        'cost-center' => 'CC-1020'
    ]
  ]),
  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"

	payload := strings.NewReader("{\n  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\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")
  .header("Content-Type", "application/json")
  .body("{\n  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\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

Create a trip

curl --request POST \
  --url https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips \
  --header 'Content-Type: application/json' \
  --data '
{
  "customFields": {
    "cost-center": "CC-1020"
  }
}
'

import requests

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

payload = { "customFields": { "cost-center": "CC-1020" } }
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({customFields: {'cost-center': 'CC-1020'}})
};

fetch('https://api.travel.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/trips', 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",
  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([
    'customFields' => [
        'cost-center' => 'CC-1020'
    ]
  ]),
  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"

	payload := strings.NewReader("{\n  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\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")
  .header("Content-Type", "application/json")
  .body("{\n  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"customFields\": {\n    \"cost-center\": \"CC-1020\"\n  }\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"
}

The reservation is asynchronous, so the answer is 202 Accepted with the trip; a trip still PENDING is being reserved. Read the trip to follow it to RESERVED, then issue it before its reservationExpiresAt. Send exactly one of air, hotel, bus or vehicle, using the ids from the search responses and your passengers’ IDs. Every required trip custom field of the organization must be in customFields; they can’t be changed afterwards. The booking is placed with the travel provider before the trip is recorded, so a request that fails with a 4xx booked nothing and can be corrected and sent again. An error the provider reports about the booking — a seat or fare no longer available, say — is returned with its own status, code and message. Each request books once: repeating a request that succeeded books a second trip, and so may repeating one that failed with a 503, whose outcome at the provider is unknown.

Path Parameters

realmId

string<uuid>

required

ID of your realm.

Format: UUID

organizationId

string<uuid>

required

ID of the organization to book the trip for.

Format: UUID

Body

application/json

air

object

The flight to book: one air search item. Send exactly one of air, hotel, bus or vehicle — a trip is one booked product.

Show child attributes

hotel

object

The hotel stay to book: one hotel search item. Send exactly one of air, hotel, bus or vehicle — a trip is one booked product.

Show child attributes

bus

object

The bus ticket to book: one passenger on one bus search item — book each passenger as a separate trip. Send exactly one of air, hotel, bus or vehicle — a trip is one booked product.

Show child attributes

vehicle

object

The vehicle rental to book: one vehicle search item. Send exactly one of air, hotel, bus or vehicle — a trip is one booked product.

Show child attributes

customFields

object

Values of the organization's trip custom fields, keyed by the custom field's slug. Every required one must be present. They can't be changed after the trip is created.

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

Show child attributes

Example:

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

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

Create a trip

Path Parameters

Body

Response