Search trips

POST

/trips

POST

/trips

curl -X POST https://travel-data-api.bcdtravel.com/trips \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "limit": 15,
  "offset": 0,
  "sort": [],
  "filter": {}
}'

200Trips_search_example

"{\n    \"code\": 200,\n    \"status\": \"ok\",\n    \"remainingRecords\": 25,\n    \"result\": [\n        {\n            \"identification\": {\n                \"id\": \"2b0e301b-3865-4e62-a34b-397271bd45xx\",\n                \"sourceId\": \"780569999999999\",\n                \"recordLocator\": \"BMSXXXX\",\n                \"gds\": \"SABRE\",\n                \"globalCustomerNumber\": \"9999\",\n                \"accountId\": \"9999999999\",\n                \"accountCountryCode\": \"US\",\n                \"customerNumber\": \"0000000000\",\n                \"customerName\": \"Company 123 USA\",\n                \"creationOfficeId\": \"D2V0\",\n                \"agentSignature\": \"AMS\",\n                \"pseudoCityCode\": \"D2V0\",\n                \"dataType\": \"BCD\",\n                \"dataProvider\": \"US\"\n            },\n            \"tripDetails\": {\n                \"bookingDateTime\": \"2020-06-26T16:02:00Z\",\n                \"ticketedDateTime\": \"2020-07-06T00:00:00Z\",\n                \"sourceModifiedDateTime\": \"2020-07-06T18:15:20Z\",\n                \"lastModifiedDateTime\": \"2020-07-06T18:19:18Z\",\n                \"tripStartDateTime\": \"2020-07-12T14:40:00-04:00\",\n                \"tripStartTimezone\": {\n                    \"offset\": -14400,\n                    \"name\": \"America/New_York\",\n                    \"abbreviation\": \"EDT\"\n                },\n                \"tripEndDateTime\": \"2020-07-22T17:35:00-04:00\",\n                \"tripEndTimezone\": {\n                    \"offset\": -14400,\n                    \"name\": \"America/New_York\",\n                    \"abbreviation\": \"EDT\"\n                },\n                \"title\": \"San Francisco, CA\",\n                \"tripStatus\": \"upcoming\",\n                \"isCancelled\": false,\n                \"flightType\": \"openJaw\",\n                \"isInternational\": false,\n                \"itineraryRemarks\": []\n            },\n            \"travelers\": [\n                {\n                    \"travelerNumber\": \"1\",\n                    \"name\": {\n                        \"firstName\": \"User1\",\n                        \"middleName\": \"Middle\",\n                        \"lastName\": \"DevTest\"\n                    },\n                    \"nameInGds\": \"devTest/User1\",\n                    \"loyaltyMemberships\": [\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"AA\",\n                            \"memberNumber\": \"XXX30X8\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"AS\",\n                            \"memberNumber\": \"XXX83981\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"DL\",\n                            \"memberNumber\": \"XXX8679124\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"UA\",\n                            \"memberNumber\": \"RPHXXX54\"\n                        }\n                    ],\n                    \"seatPreferences\": [\n                        {\n                            \"locationCode\": \"AFN\",\n                            \"locationText\": \"Aisle, Forward, Non-Smoking\",\n                            \"notes\": \"COMPLEAT-SEAT PREFS/AFN\"\n                        }\n                    ]\n                },\n                {\n                    \"travelerNumber\": \"2\",\n                    \"name\": {\n                        \"firstName\": \"User2\",\n                        \"middleName\": \"Middle\",\n                        \"lastName\": \"DevTest\"\n                    },\n                    \"nameInGds\": \"devTest/User2\",\n                    \"loyaltyMemberships\": [\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"AA\",\n                            \"memberNumber\": \"XXX30X2\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"AS\",\n                            \"memberNumber\": \"XXX83982\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"DL\",\n                            \"memberNumber\": \"XXX8679122\"\n                        },\n                        {\n                            \"supplierType\": \"Air\",\n                            \"supplier\": \"UA\",\n                            \"memberNumber\": \"RPHXXX52\"\n                        }\n                    ],\n                    \"seatPreferences\": [\n                        {\n                            \"locationCode\": \"W\",\n                            \"locationText\": \"Window\",\n                            \"notes\": \"COMPLEAT-SEAT PREFS/W\"\n                        }\n                    ]\n                }\n            ],\n            \"contacts\": {\n                \"phoneNumbers\": [\n                    {\n                        \"number\": \"555-555-5554\",\n                        \"type\": \"Agent\"\n                    },\n                    {\n                        \"number\": \"1-555-555-5555\",\n                        \"type\": \"Cellular\"\n                    },\n                ],\n                \"emailAddresses\": [\n                    {\n                        \"emailAddress\": \"DEVTESTUSER31@BCDTRAVEL.COM\",\n                        \"type\": \"TO\",\n                        \"isPrimary\": true\n                    }\n                ]\n            },\n            \"segments\": [\n                {\n                    \"type\": \"Air\",\n                    \"segmentNumber\": 1,\n                    \"title\": \"San Francisco United Airlines\",\n                    \"confirmationNumber\": \"ABC123\",\n                    \"startDateTime\": \"2020-07-12T14:40:00-04:00\",\n                    \"startTimezone\": {\n                        \"name\": \"America/New_York\",\n                        \"code\": \"EDT\"\n                    },\n                    \"endDateTime\": \"2020-07-12T17:50:00-07:00\",\n                    \"endTimezone\": {\n                        \"name\": \"America/Los_Angeles\",\n                        \"code\": \"PDT\"\n                    },\n                    \"status\": {\n                        \"code\": \"HK\",\n                        \"description\": \"Booked\"\n                    },\n                    \"departureAirport\": {\n                        \"airport\": {\n                            \"code\": \"EWR\",\n                            \"name\": \"Newark Liberty International Airport\",\n                            \"address\": {\n                                \"address1\": \"Building 1\",\n                                \"address2\": \"Conrad Road\",\n                                \"city\": {\n                                    \"name\": \"Newark\"\n                                },\n                                \"region\": {\n                                    \"code\": \"NJ\",\n                                    \"name\": \"New Jersey\"\n                                },\n                                \"postalCode\": \"7114\",\n                                \"country\": {\n                                    \"code\": \"US\",\n                                    \"name\": \"United States\"\n                                },\n                                \"coordinates\": {\n                                    \"latitude\": \"40.68907\",\n                                    \"longitude\": \"-74.17876\"\n                                }\n                            },\n                            \"metroArea\": {\n                                \"code\": \"NYC\",\n                                \"name\": \"New York\"\n                            },\n                            \"isMajorAirport\": true\n                        },\n                        \"terminal\": \"TERMINAL C\"\n                    },\n                    \"arrivalAirport\": {\n                        \"airport\": {\n                            \"code\": \"SFO\",\n                            \"name\": \"San Francisco International Airport\",\n                            \"address\": {\n                                \"city\": {\n                                    \"name\": \"San Francisco\"\n                                },\n                                \"region\": {\n                                    \"code\": \"CA\",\n                                    \"name\": \"California\"\n                                },\n                                \"postalCode\": \"94128\",\n                                \"country\": {\n                                    \"code\": \"US\",\n                                    \"name\": \"United States\"\n                                },\n                                \"coordinates\": {\n                                    \"latitude\": \"37.615215\",\n                                    \"longitude\": \"-122.38988\"\n                                }\n                            },\n                            \"metroArea\": {},\n                            \"isMajorAirport\": true\n                        },\n                        \"terminal\": \"TERMINAL 3\"\n                    },\n                    \"marketingFlight\": {\n                        \"airlineCode\": \"UA\",\n                        \"airlineName\": \"United Airlines\",\n                        \"flightNumber\": \"2261\"\n                    },\n                    \"operatingFlight\": {},\n                    \"isInternational\": false,\n                    \"flightDirection\": \"outbound\",\n                    \"ticket\": {\n                        \"isTicketed\": true,\n                        \"ticketNumber\": \"ABC123\",\n                        \"isTicketless\": false,\n                        \"isETicketCandidate\": true\n                    },\n                    \"seatSelections\": [\n                        {\n                            \"travelerNumber\": \"1\",\n                            \"location\": \"11E\"\n                        }\n                    ],\n                    \"mealPreferences\": [],\n                    \"meal\": {\n                        \"hasSpecialMeal\": 0\n                    },\n                    \"equipment\": {\n                        \"code\": \"752\"\n                    },\n                    \"classOfService\": {\n                        \"code\": \"S\",\n                        \"description\": \"Economy\"\n                    },\n                    \"inFlightServices\": {\n                        \"code\": \"10\",\n                        \"description\": \"Non Smoking\"\n                    },\n                    \"flightDistance\": 2557,\n                    \"calculatedDefra\": 554.84,\n                    \"calculatedDefrarf\": 1049.06,\n                    \"calculatedGhgp\": 340.08,\n                    \"calculatedDuration\": \"370\",\n                    \"numberOfStops\": 0,\n                    \"isScheduleChange\": false,\n                    \"isFlown\": false,\n                    \"isChangeOfGuage\": false,\n                    \"marriedSegments\": [],\n                    \"connectedSegments\": [],\n                    \"isPassive\": false,\n                    \"isCancelled\": false\n                },\n                {\n                    \"type\": \"Car\",\n                    \"segmentNumber\": 2,\n                    \"title\": \"San Francisco\",\n                    \"confirmationNumber\": \"J446377L123456\",\n                    \"startDateTime\": \"2020-07-12T17:50:00-07:00\",\n                    \"startTimezone\": {\n                        \"name\": \"America/Los_Angeles\",\n                        \"code\": \"PDT\"\n                    },\n                    \"endDateTime\": \"2020-07-13T00:00:00\",\n                    \"status\": {\n                        \"code\": \"HK\",\n                        \"description\": \"Booked\"\n                    },\n                    \"rentalCompany\": {\n                        \"code\": \"EZ\",\n                        \"name\": \"Hurts Rent-A-Car\",\n                        \"phone\": {\n                            \"number\": \"555-555-6600\"\n                        }\n                    },\n                    \"pickupLocation\": {\n                        \"address\": {\n                            \"address1\": \"Hertz San Francisco International Airport\",\n                            \"address2\": \"780 McDonnell Road\",\n                            \"city\": {\n                                \"name\": \"San Francisco\"\n                            },\n                            \"region\": {\n                                \"code\": \"CA\",\n                                \"name\": \"California\"\n                            },\n                            \"postalCode\": \"94128\",\n                            \"country\": {\n                                \"code\": \"US\"\n                            },\n                            \"notes\": \"SFO\"\n                        },\n                        \"airportCode\": \"SFO\"\n                    },\n                    \"dropoffLocation\": {\n                        \"address\": {\n                            \"address1\": \"San Francisco Downtown 325 Mason Street Between Geary and Ofarrell Streets\",\n                            \"city\": {\n                                \"name\": \"San Francisco\"\n                            },\n                            \"region\": {\n                                \"code\": \"CA\",\n                                \"name\": \"California\"\n                            },\n                            \"postalCode\": \"94102-1796\",\n                            \"country\": {\n                                \"code\": \"US\"\n                            },\n                            \"notes\": \"SFOC010\"\n                        },\n                        \"airportCode\": \"SFOC010\",\n                        \"dropoffSpot\": \"C010\"\n                    },\n                    \"arrivalFlight\": {},\n                    \"isInternational\": false,\n                    \"numberOfDays\": 1,\n                    \"numberOfHours\": 0,\n                    \"calculatedDuration\": \"370\",\n                    \"numberOfCars\": 1,\n                    \"car\": {\n                        \"type\": {\n                            \"description\": \"Full Size SZ Auto AC\"\n                        },\n                        \"specialEquipment\": []\n                    },\n                    \"fare\": {\n                        \"rateCode\": \"IX2123\",\n                        \"rateType\": 1,\n                        \"rateSchedule\": 2,\n                        \"baseRate\": {\n                            \"amount\": 15.99,\n                            \"currency\": \"USD\"\n                        },\n                        \"estimatedTotalRate\": {\n                            \"amount\": 39.98,\n                            \"currency\": \"USD\"\n                        },\n                        \"totalMandatoryCharges\": \"USD 23.99\",\n                        \"extraHourFee\": {\n                            \"amount\": 399.67,\n                            \"currency\": \"USD\"\n                        },\n                        \"mileCharge\": {\n                            \"amount\": 0.10,\n                            \"currency\": \"USD\"\n                        },\n                        \"guaranteedRate\": {\n                            \"amount\": 15.99,\n                            \"currency\": \"USD\"\n                        },\n                        \"dropCharge\": {\n                            \"amount\": 0.00\n                        },\n                        \"extraHourMileageFee\": {\n                            \"amount\": 0.10,\n                            \"currency\": \"USD\"\n                        },\n                        \"mileageAllowance\": \"170 Free Miles\",\n                        \"extraDayMileageAllowance\": \" Free Miles Per Extra Day\",\n                        \"extraHourMileageAllowance\": \"60F Free Miles Per Extra Hour\",\n                        \"distanceUnitOfMeasure\": 0,\n                        \"dcsAuxRateCode\": \"@IX2123\",\n                        \"corporateDiscountNumber\": \"123456\"\n                    },\n                    \"bookingSource\": \"33580123123\",\n                    \"loyaltyMemberships\": [],\n                    \"isPassive\": false,\n                    \"isCancelled\": false,\n                    \"segmentRemarks\": [\n                        \"CAR COMPANY MAY CHARGE FEE FOR MILEAGE POINTS\"\n                    ]\n                },\n                {\n                    \"type\": \"Hotel\",\n                    \"segmentNumber\": 3,\n                    \"title\": \"Hotel Griffon\",\n                    \"confirmationNumber\": \"15814ABC123\",\n                    \"startDateTime\": \"2020-07-12T15:00:00-07:00\",\n                    \"startTimezone\": {\n                        \"name\": \"America/Los_Angeles\",\n                        \"code\": \"PDT\"\n                    },\n                    \"endDateTime\": \"2020-07-17T11:00:00-07:00\",\n                    \"endTimezone\": {\n                        \"name\": \"America/Los_Angeles\",\n                        \"code\": \"PDT\"\n                    },\n                    \"status\": {\n                        \"code\": \"HK\",\n                        \"description\": \"Booked\"\n                    },\n                    \"reservationName\": \"LAST/FIRST MIDDLE\",\n                    \"property\": {\n                        \"code\": \"19123\",\n                        \"name\": \"Hotel Griffon\",\n                        \"hotelChain\": {\n                            \"code\": \"LE\"\n                        },\n                        \"phone\": {\n                            \"number\": \"+1 (555) 555-5555\"\n                        },\n                        \"address\": {\n                            \"address1\": \"155 Steuart Street\",\n                            \"city\": {\n                                \"code\": \"SFO\",\n                                \"name\": \"San Francisco\"\n                            },\n                            \"region\": {\n                                \"code\": \"CA\",\n                                \"name\": \"California\"\n                            },\n                            \"postalCode\": \"94105\",\n                            \"country\": {\n                                \"code\": \"US\"\n                            },\n                            \"notes\": \"155 STEUART STREET SAN FRANCISCO CA 94105 US\"\n                        },\n                        \"airportCode\": \"SFO\"\n                    },\n                    \"numberOfNights\": 5,\n                    \"calculatedDuration\": \"6960\",\n                    \"numberOfRooms\": 1,\n                    \"room\": {\n                        \"type\": {\n                            \"code\": \"123\"\n                        },\n                        \"numberOfGuests\": 1,\n                        \"specialInstructions\": \"REQ KING BAY BRIDGE VIEW\"\n                    },\n                    \"fare\": {\n                        \"rateCode\": \"ABC\",\n                        \"rateSchedule\": 1,\n                        \"isMultiDateRate\": 2,\n                        \"rate\": {\n                            \"amount\": 206.10,\n                            \"currency\": \"USD\"\n                        },\n                        \"estimatedTotalRate\": {\n                            \"amount\": 949.50,\n                            \"currency\": \"USD\"\n                        },\n                        \"rateChangeDuringStay\": 2,\n                        \"rateChangeInfos\": [\n                            {\n                                \"beginDateTime\": \"2020-07-12 00:00:00\",\n                                \"endDateTime\": \"2020-07-13 00:00:00\",\n                                \"rate\": {\n                                    \"amount\": 161.10,\n                                    \"currency\": \"USD\"\n                                },\n                                \"roomType\": {}\n                            }\n                        ],\n                        \"creditCardGuarantee\": \"CC42XXXXXXXXX1234EXP 20 24-LAST\"\n                    },\n                    \"bookingSource\": \"33580123123\",\n                    \"cancellationPolicy\": \"Cancel 1 day prior to arrival local hotel time to avoid any charges.\",\n                    \"overview\": \" 3 SFO IN12JUL S-OUT17JUL  5NT\"\n\t\t\t\t\t\"loyaltyMemberships\": [],\n                    \"isPassive\": false,\n                    \"isCancelled\": false,\n                    \"isFinalDestination\": true,\n                    \"segmentRemarks\": [\n                        \"EARLY DEPARTURE MAY RESULT IN A FEE\"\n                    ]\n                },\n                {\n                    \"type\": \"Air\",\n                    \"segmentNumber\": 5,\n                    \"title\": \"Newark United Airlines\",\n                    \"confirmationNumber\": \"ABC123\",\n                    \"startDateTime\": \"2020-07-22T12:00:00-06:00\",\n                    \"startTimezone\": {\n                        \"name\": \"America/Denver\",\n                        \"code\": \"MDT\"\n                    },\n                    \"endDateTime\": \"2020-07-22T17:35:00-04:00\",\n                    \"endTimezone\": {\n                        \"name\": \"America/New_York\",\n                        \"code\": \"EDT\"\n                    },\n                    \"status\": {\n                        \"code\": \"HK\",\n                        \"description\": \"Booked\"\n                    },\n                    \"departureAirport\": {\n                        \"airport\": {\n                            \"code\": \"DEN\",\n                            \"name\": \"Denver International Airport\",\n                            \"address\": {\n                                \"address1\": \"8500 Pena Boulevard\",\n                                \"city\": {\n                                    \"name\": \"Denver\"\n                                },\n                                \"region\": {\n                                    \"code\": \"CO\",\n                                    \"name\": \"Colorado\"\n                                },\n                                \"postalCode\": \"80249-6340\",\n                                \"country\": {\n                                    \"code\": \"US\",\n                                    \"name\": \"United States\"\n                                },\n                                \"coordinates\": {\n                                    \"latitude\": \"39.851383\",\n                                    \"longitude\": \"-104.673096\"\n                                }\n                            },\n                            \"metroArea\": {\n                                \"code\": \"DEN\",\n                                \"name\": \"Denver\"\n                            },\n                            \"isMajorAirport\": true\n                        }\n                    },\n                    \"arrivalAirport\": {\n                        \"airport\": {\n                            \"code\": \"EWR\",\n                            \"name\": \"Newark Liberty International Airport\",\n                            \"address\": {\n                                \"address1\": \"Building 1\",\n                                \"address2\": \"Conrad Road\",\n                                \"city\": {\n                                    \"name\": \"Newark\"\n                                },\n                                \"region\": {\n                                    \"code\": \"NJ\",\n                                    \"name\": \"New Jersey\"\n                                },\n                                \"postalCode\": \"7114\",\n                                \"country\": {\n                                    \"code\": \"US\",\n                                    \"name\": \"United States\"\n                                },\n                                \"coordinates\": {\n                                    \"latitude\": \"40.68907\",\n                                    \"longitude\": \"-74.17876\"\n                                }\n                            },\n                            \"metroArea\": {\n                                \"code\": \"NYC\",\n                                \"name\": \"New York\"\n                            },\n                            \"isMajorAirport\": true\n                        },\n                        \"terminal\": \"TERMINAL C\"\n                    },\n                    \"marketingFlight\": {\n                        \"airlineCode\": \"UA\",\n                        \"airlineName\": \"United Airlines\",\n                        \"flightNumber\": \"513\"\n                    },\n                    \"operatingFlight\": {},\n                    \"isInternational\": false,\n                    \"flightDirection\": \"outbound\",\n                    \"ticket\": {\n                        \"isTicketed\": true,\n                        \"ticketNumber\": \"ABC123\",\n                        \"isTicketless\": false,\n                        \"isETicketCandidate\": true\n                    },\n                    \"seatSelections\": [\n                        {\n                            \"travelerNumber\": \"1\",\n                            \"location\": \"20C\"\n                        }\n                    ],\n                    \"mealPreferences\": [],\n                    \"meal\": {\n                        \"hasSpecialMeal\": 0\n                    },\n                    \"equipment\": {\n                        \"code\": \"320\"\n                    },\n                    \"classOfService\": {\n                        \"code\": \"K\",\n                        \"description\": \"Economy\"\n                    },\n                    \"inFlightServices\": {\n                        \"code\": \"10\",\n                        \"description\": \"Non Smoking\"\n                    },\n                    \"flightDistance\": 1600,\n                    \"calculatedDefra\": 347.18,\n                    \"calculatedDefrarf\": 656.43,\n                    \"calculatedGhgp\": 212.8,\n                    \"calculatedDuration\": \"215\",\n                    \"numberOfStops\": 0,\n                    \"isScheduleChange\": false,\n                    \"isFlown\": false,\n                    \"isChangeOfGuage\": false,\n                    \"marriedSegments\": [],\n                    \"connectedSegments\": [],\n                    \"isPassive\": false,\n                    \"isCancelled\": false\n                }\n            ],\n            \"fareInfos\": [\n                {\n                    \"segmentNumbers\": [\n                        \"1\",\n                        \"5\"\n                    ],\n                    \"fare\": {\n                        \"amount\": 128.00,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    },\n                    \"estimatedTotalFare\": {\n                        \"amount\": 128.00,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    }\n                },\n                {\n                    \"segmentNumbers\": [\n                        \"2\"\n                    ],\n                    \"fare\": {\n                        \"amount\": 15.99,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    },\n                    \"estimatedTotalFare\": {\n                        \"amount\": 39.98,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    }\n                },\n                {\n                    \"segmentNumbers\": [\n                        \"3\"\n                    ],\n                    \"fare\": {\n                        \"amount\": 206.10,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    },\n                    \"estimatedTotalFare\": {\n                        \"amount\": 949.50,\n                        \"currency\": \"USD\",\n                        \"description\": \"USD\"\n                    }\n                }\n            ],\n            \"remarks\": [\n                {\n                    \"lineNumber\": 1,\n                    \"type\": 10,\n                    \"category\": \"Y\",\n                    \"contents\": \"TOEN-DEVTESTUSER3.AT.BCDTRAVEL.COM\"\n                },\n                {\n                    \"lineNumber\": 6,\n                    \"type\": 10,\n                    \"category\": \"X\",\n                    \"contents\": \"TID-NA-9999999999-9999\"\n                },\n                {\n                    \"lineNumber\": 8,\n                    \"type\": 10,\n                    \"category\": \"Q\",\n                    \"contents\": \"DO NOT TICKET\"\n                },\n                {\n                    \"lineNumber\": 9,\n                    \"type\": 10,\n                    \"category\": \"S\",\n                    \"contents\": \"VIP\"\n                }\n            ]\n        }\n\t]\n}\n\n"

Search for trip records with filters and sorting.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

limitintegerOptional

offsetintegerOptional

sortlist of anyOptional

filterobjectOptional

Response

SearchTrips