> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://bcdtravel.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://bcdtravel.ferndocs.com/_mcp/server. # Generate token POST https://travel-data-api.bcdtravel.com/oauth2/token Generate an access token using OAuth 2.0 client credentials. Reference: https://bcdtravel.ferndocs.com/itinerary/api-reference/travel-data-api-itinerary/auth/generate-token ## Servers - `https://travel-data-api.bcdtravel.com` (https://travel-data-api.bcdtravel.com, default) - `https://auth.travel-data-api.bcdtravel.com` (https://auth.travel-data-api.bcdtravel.com) ## Response ### 200 SearchTrips ## Examples **Response** ```json "{\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" ``` **SDK Code** ```python Auth_generateToken_example import requests url = "https://travel-data-api.bcdtravel.com/oauth2/token" response = requests.post(url) print(response.json()) ``` ```javascript Auth_generateToken_example const url = 'https://travel-data-api.bcdtravel.com/oauth2/token'; const options = {method: 'POST'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Auth_generateToken_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://travel-data-api.bcdtravel.com/oauth2/token" req, _ := http.NewRequest("POST", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Auth_generateToken_example require 'uri' require 'net/http' url = URI("https://travel-data-api.bcdtravel.com/oauth2/token") 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 ``` ```java Auth_generateToken_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://travel-data-api.bcdtravel.com/oauth2/token") .asString(); ``` ```php Auth_generateToken_example request('POST', 'https://travel-data-api.bcdtravel.com/oauth2/token'); echo $response->getBody(); ``` ```csharp Auth_generateToken_example using RestSharp; var client = new RestClient("https://travel-data-api.bcdtravel.com/oauth2/token"); var request = new RestRequest(Method.POST); IRestResponse response = client.Execute(request); ``` ```swift Auth_generateToken_example import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://travel-data-api.bcdtravel.com/oauth2/token")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```