curl --request GET \
--url https://api.example.com/v1/trip/{trip_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.example.com/v1/trip/{trip_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.example.com/v1/trip/{trip_id}', 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.example.com/v1/trip/{trip_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.example.com/v1/trip/{trip_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.example.com/v1/trip/{trip_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/trip/{trip_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"trip_id": "trip_1048576",
"status": "draft",
"travelers": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"gender": "MALE",
"passenger_type": "ADULT"
}
],
"contact": {
"email": "<string>",
"phone": "<string>",
"title": "<string>"
},
"items": [
{
"item_id": "itm_4b91c2",
"kind": "flight",
"offer_id": "htl_2d67a7441c60e5de",
"trip_item_token": "of_9c1d2e:FARE_ABC",
"hotel_id": "lp1f2c3",
"price": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"pax_count": 1,
"available_ancillaries": [
{
"offer_id": "anc_bag_20kg",
"type": "bag",
"label": "bag&1 x large 55 x 40 x 20 cm&Includes Speedy Boarding",
"display_label": "bag, 1 x large 55 x 40 x 20 cm, Includes Speedy Boarding",
"description": "<string>",
"price_per_unit": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"per_pax": true,
"max_quantity": 2,
"paid_at": "now"
}
],
"selected_ancillaries": [
{
"offer_id": "anc_bag_20kg",
"pax_ref_id": "pax_1",
"quantity": 1
}
],
"price_changed": true,
"original_price": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"required_attributes": {
"source": "provider",
"per_passenger": [
"PassportNumber",
"PassportExpiryDate",
"DateOfBirth"
],
"booking": [
"BillingAddress",
"PostCode"
],
"per_passenger_conditional": [
"Nationality"
],
"booking_conditional": [
"<string>"
]
},
"hotel_terms": {
"terms_as_of": "search",
"taxes_breakdown": [
{
"amount": 164.49,
"currency": "EUR",
"description": "19, VAT National taxes on accommodation",
"included": true
}
],
"cancellation_schedule": [
{
"cancel_time": "2026-08-18T10:00:00+02:00",
"amount": 606.13,
"currency": "EUR",
"type": "amount"
}
],
"free_cancellation_until": "2026-08-18T10:00:00+02:00",
"is_refundable": false,
"board_type": "RO",
"board_name": "Room Only",
"payment_types": [
"NUITEE_PAY"
],
"room_name": "Superior Double",
"room_capacity": 2
}
}
],
"total_amount": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"quote": {
"quoted_cart_id": 2097152,
"status": "quoted",
"expires_at": "2026-06-01T13:04:56Z"
},
"fulfillment": {
"fulfillment_cart_id": 123,
"status": "<string>",
"phase": "<string>"
},
"bookings": [
{
"item_id": "itm_4b91c2",
"kind": "flight",
"booking_reference": "JNK-A0AUR2",
"pnr": "XM9L2K",
"provider_status": "CONFIRMED",
"offer_id": "htl_2d67a7441c60e5de",
"trip_item_token": "of_9c1d2e:FARE_ABC",
"hotel_id": "lp1f2c3"
}
],
"created_at": "2026-06-01T12:30:00Z",
"updated_at": "2026-06-01T12:34:56Z"
}{
"error": {
"code": "BAD_REQUEST",
"message": "Malformed JSON in request body.",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "AUTH_REQUIRED",
"message": "Invalid or expired API key.",
"doc_url": "https://docs.gojinko.com/api-reference/authentication"
}
}{
"error": {
"code": "PAYMENT_REQUIRED",
"message": "Insufficient balance — this call costs $0.0150 and your organization has $0.0000 available. Top up at https://dashboard.gojinko.com/developers/billing/topup",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "CONFLICT",
"message": "an exchange is already in progress for this booking",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "origins: origins is required; trip_type: trip_type is required",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit or quota exceeded.",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_REJECTED",
"message": "sabre-rest BargainFinderMaxRQ failed with status 400: 27131 - Number of connection locations exceeds maximum allowed",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "All flight providers are temporarily unable to serve this search. Please retry later. Provider reasons: sabre-rest: provider temporarily closed; travelfusion: quota exhausted",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "sabre-rest BargainFinderMaxRQ timed out after 30s",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}trip-status
Fetch the full lifecycle state of a trip, items, travelers, quote, fulfillment, and any booking references
curl --request GET \
--url https://api.example.com/v1/trip/{trip_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.example.com/v1/trip/{trip_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.example.com/v1/trip/{trip_id}', 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.example.com/v1/trip/{trip_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.example.com/v1/trip/{trip_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.example.com/v1/trip/{trip_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/trip/{trip_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"trip_id": "trip_1048576",
"status": "draft",
"travelers": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"gender": "MALE",
"passenger_type": "ADULT"
}
],
"contact": {
"email": "<string>",
"phone": "<string>",
"title": "<string>"
},
"items": [
{
"item_id": "itm_4b91c2",
"kind": "flight",
"offer_id": "htl_2d67a7441c60e5de",
"trip_item_token": "of_9c1d2e:FARE_ABC",
"hotel_id": "lp1f2c3",
"price": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"pax_count": 1,
"available_ancillaries": [
{
"offer_id": "anc_bag_20kg",
"type": "bag",
"label": "bag&1 x large 55 x 40 x 20 cm&Includes Speedy Boarding",
"display_label": "bag, 1 x large 55 x 40 x 20 cm, Includes Speedy Boarding",
"description": "<string>",
"price_per_unit": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"per_pax": true,
"max_quantity": 2,
"paid_at": "now"
}
],
"selected_ancillaries": [
{
"offer_id": "anc_bag_20kg",
"pax_ref_id": "pax_1",
"quantity": 1
}
],
"price_changed": true,
"original_price": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"required_attributes": {
"source": "provider",
"per_passenger": [
"PassportNumber",
"PassportExpiryDate",
"DateOfBirth"
],
"booking": [
"BillingAddress",
"PostCode"
],
"per_passenger_conditional": [
"Nationality"
],
"booking_conditional": [
"<string>"
]
},
"hotel_terms": {
"terms_as_of": "search",
"taxes_breakdown": [
{
"amount": 164.49,
"currency": "EUR",
"description": "19, VAT National taxes on accommodation",
"included": true
}
],
"cancellation_schedule": [
{
"cancel_time": "2026-08-18T10:00:00+02:00",
"amount": 606.13,
"currency": "EUR",
"type": "amount"
}
],
"free_cancellation_until": "2026-08-18T10:00:00+02:00",
"is_refundable": false,
"board_type": "RO",
"board_name": "Room Only",
"payment_types": [
"NUITEE_PAY"
],
"room_name": "Superior Double",
"room_capacity": 2
}
}
],
"total_amount": {
"amount": 123,
"value": 41250,
"currency": "USD",
"decimal_places": 2
},
"quote": {
"quoted_cart_id": 2097152,
"status": "quoted",
"expires_at": "2026-06-01T13:04:56Z"
},
"fulfillment": {
"fulfillment_cart_id": 123,
"status": "<string>",
"phase": "<string>"
},
"bookings": [
{
"item_id": "itm_4b91c2",
"kind": "flight",
"booking_reference": "JNK-A0AUR2",
"pnr": "XM9L2K",
"provider_status": "CONFIRMED",
"offer_id": "htl_2d67a7441c60e5de",
"trip_item_token": "of_9c1d2e:FARE_ABC",
"hotel_id": "lp1f2c3"
}
],
"created_at": "2026-06-01T12:30:00Z",
"updated_at": "2026-06-01T12:34:56Z"
}{
"error": {
"code": "BAD_REQUEST",
"message": "Malformed JSON in request body.",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "AUTH_REQUIRED",
"message": "Invalid or expired API key.",
"doc_url": "https://docs.gojinko.com/api-reference/authentication"
}
}{
"error": {
"code": "PAYMENT_REQUIRED",
"message": "Insufficient balance — this call costs $0.0150 and your organization has $0.0000 available. Top up at https://dashboard.gojinko.com/developers/billing/topup",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "CONFLICT",
"message": "an exchange is already in progress for this booking",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "origins: origins is required; trip_type: trip_type is required",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit or quota exceeded.",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_REJECTED",
"message": "sabre-rest BargainFinderMaxRQ failed with status 400: 27131 - Number of connection locations exceeds maximum allowed",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "All flight providers are temporarily unable to serve this search. Please retry later. Provider reasons: sabre-rest: provider temporarily closed; travelfusion: quota exhausted",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}{
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "sabre-rest BargainFinderMaxRQ timed out after 30s",
"doc_url": "https://docs.gojinko.com/concepts/errors"
}
}Authorizations
Path Parameters
Response
The trip
"trip_1048576"
Where the trip is in its lifecycle. expired is the 24-hour lapse: it is evaluated LAZILY, on the read that first observes it, so this call is where a dead trip becomes visible. Once a trip is expired, adding items, setting travelers and checkout are refused with TRIP_EXPIRED; any other state that refuses a write answers TRIP_STATE_CONFLICT and names the state here. Start a new trip — a lapsed one cannot be revived.
draft, quoting, quoted, fulfillment_prepared, fulfilling, fulfilled, partially_fulfilled, failed, cancelled, expired "draft"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
{
"quoted_cart_id": 2097152,
"status": "quoted",
"expires_at": "2026-06-01T13:04:56Z"
}
Show child attributes
Show child attributes
One entry per booked item, present once fulfillment has produced provider bookings.
Show child attributes
Show child attributes
"2026-06-01T12:30:00Z"
"2026-06-01T12:34:56Z"
