Amadeus · Example Payload

Hotel Booking Hotel Booking Example

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Hotel Booking Hotel Booking Example is an example object payload from Amadeus, with 9 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

typeidbookingStatusroomAssociationshotelhotelProviderInformationpaymenttravelAgentIdarrivalInformation

Example Payload

{
  "type": "string-value",
  "id": "456123",
  "bookingStatus": "CONFIRMED",
  "roomAssociations": [
    {
      "guestReferences": [
        {
          "guestReference": "string-value",
          "hotelLoyaltyId": "3081031320523260"
        }
      ],
      "specialRequest": "TEST I will arrive at midnight",
      "hotelOfferId": "63A93695B58821ABB0EC2B33FE9FAB24D72BF34B1BD7D707293763D8D9378FC3"
    }
  ],
  "hotel": {
    "hotelId": "ADPAR001",
    "chainCode": "AD",
    "name": "Hotel de Paris",
    "self": "string-value"
  },
  "hotelProviderInformation": [
    {
      "hotelProviderCode": "RT",
      "confirmationNumber": "818319951754",
      "cancellationNumber": "C818319951754",
      "onRequestNumber": "818319951754"
    }
  ],
  "payment": {
    "iataTravelAgency": {
      "iataNumber": "CDG"
    },
    "billBack": {
      "travelAgencyId": "12345",
      "bookerId": "12345",
      "paymentInstructions": "string-value",
      "billbackProviderDeploymentId": "12345",
      "billbackProviderCode": "string-value",
      "billbackProviderAccountNumber": 1,
      "hotelSupplierInformation": {
        "phone": "+33679278416",
        "fax": "+33679278417",
        "email": "hotel@brand.com"
      }
    },
    "method": "CREDIT_CARD",
    "b2bWallet": {
      "virtualCreditCardId": "12345",
      "paymentProvider": "string-value"
    },
    "paymentCard": {
      "paymentCardInfo": {
        "vendorCode": "VI",
        "holderName": "Sample Name",
        "cardNumber": 1,
        "expiryDate": "2026-08-15"
      },
      "cardOwnerType": "TravelAgency",
      "VCC": true,
      "address": {
        "lines": [],
        "postalCode": "string-value",
        "countryCode": "FR",
        "cityName": "Paris",
        "stateCode": "string-value"
      }
    }
  },
  "travelAgentId": "12345",
  "arrivalInformation": {
    "arrivalFlightDetails": {
      "carrierCode": "LH",
      "number": "1050",
      "departure": {
        "iataCode": "JFK"
      },
      "arrival": {
        "iataCode": "JFK",
        "terminal": "T2",
        "at": "2017-10-23T20:00:00+02:00"
      }
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/hotel-booking-hotel-booking-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.