Book

post

https://api-dev.despegar.com/v3/book

The book service is responsible for confirming and issuing the reservation.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

prebook_id

string

required

This field must be filled in with the information returned in the "prebook_id" field of the "prebook" service response.

external_booking_reference

string

required

This field must be filled in by the API consumer with a unique code to identify book requests, following the ISO-XXXX standard format. Note that each code must be unique to avoid processing errors - sending duplicate codes will result in an error response.

modality

string

enum

required

This field must be filled in with the payment method, the only option available is 'PAYINADVANCE'.

Allowed:

contact_data

object

required

travelers

array of objects

required

travelers*

payment

object

town_registration

number

This field is optional and must be filled in with the municipal registration, information required only for Legal Entities.

business_type

string

This field is optional and must be filled in with the type of business, information required only for Legal Entities.

customer_situation

string

This field is optional and must be filled in with the customer's situation, information required only for Legal Entities.

loyalty_data

object of objects

disable_sync_result

boolean

This parameter must be sent as a 'query parameter', for example: https://https://{{domain}}.despegar.com/v3/book?disable_sync_result=true This parameter was created to obtain a book response in less than 45 seconds (default time). When sent with 'true', the response will be returned as soon as the reservation_id is generated (on average, 2 seconds). However, the status may return as 'PROCESSING', requiring a later status. When not sent or sent with 'false', the service response time will be the default.

Responses

200OK

400Bad Request

401Unauthorized

409Conflict

500Internal Server Error