POST
/
travelers-requests
Upload travel requests
curl --request POST \
  --url https://integrations-dev.cteleport.com/travelers-requests \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
[
  {
    "externalInfo": {
      "requestId": "TR-2024-001",
      "subRequestId": "SR-001",
      "status": "new"
    },
    "flight": {
      "origin": "MNL",
      "destination": "SIN",
      "date": "2024-08-15",
      "intermediateAirports": [
        {
          "airport": "HKG",
          "date": "2024-08-15"
        }
      ]
    },
    "hotel": {
      "location": "SIN",
      "checkIn": "2024-08-15",
      "checkOut": "2024-08-17"
    },
    "details": {
      "vehicle": {
        "name": "MV Pacific Explorer",
        "flag": "PA",
        "vehicleType": "vessel"
      },
      "rank": "Chief Officer",
      "remarks": "Vegetarian meal preferred"
    },
    "traveler": {
      "lastName": "Smith",
      "firstName": "John",
      "dob": "1985-03-15",
      "nationality": "GB",
      "gender": "M",
      "docCountry": "GB",
      "docNumber": "533400831",
      "docExpireDate": "2028-06-20",
      "homeAirport": "LHR",
      "email": "john.smith@example.com",
      "phone": "+44 7911 123456"
    }
  }
]
'
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "[0].Traveler.Gender": [
      "The Gender field is required."
    ]
  }
}

Authorizations

X-Api-Key
string
header
required

API key provided by C Teleport for integration access.

Body

application/json
externalInfo
object
required

External reference information for the travel request.

traveler
object
required

Traveler record using camelCase field names.

flight
object

Flight requirements for the travel request.

hotel
object

Hotel requirements for the travel request.

details
object

Additional details for the travel request.

Response

Travel requests uploaded successfully.