GET accounts/settings

Get account entity settings

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET accounts/email-services-settings

Get email services settings

Authorization: guest member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET accounts/:account_id_or_key

Get the account detail.

Authorization: member admin superadmin

POST accounts/:account_id/upload-logo

Upload a logo image on an account.

Authorization: admin app superadmin

Attributes Type Authorization Description
logo
optional
file The logo file
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
POST accounts/:account_id/documents

Upload a document.

Authorization: admin superadmin

Attributes Type Authorization Description
file
optional
file Document
name
optional
string Document name
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
POST accounts/:account_id/documents/:id

Delete a document.

Authorization: admin superadmin

Attributes Type Authorization Description
id
optional
string Id of the document
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
GET accounts/:account_id/cards

Get the account cards list.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
number
optional
string Filter cards by number
name
optional
string Filter cards by name
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST ext/accounts/:account_id/cards

[Called by Proxy] Create an account card, with VGS Vault

Authorization:

Attributes Type Authorization Description
name
required
string The name of the card.
cvv
required
string CVV of the card.
expiration_date
required
object Expiration of the card
holder_name
required
string Holder name date of the card
number
required
string Number of the card
is_public
optional
boolean Active card to public.
allowed_users
optional
array The users that can see this card
default_bill_address_id
optional
null|string The id of the adress id.
default_invoice_profile_id
optional
null|string The invoice profile id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST ext/accounts/:account_id/cards/:card_id/vaults

[Called by Proxy] Add Vaults of an user card.

Authorization:

Attributes Type Authorization Description
cvv
optional
string CVV of the card.
expiration_date
optional
object Expiration of the card
holder_name
optional
string Holder name date of the card
number
optional
string Number of the card
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
INVALID_CARD_CC Invalid credit card.
GET accounts/:account_id/groups

Get the account groups list.

Authorization: member admin app superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
name
optional
string member,admin,superadmin Filter by name of group
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET accounts/:account_id/groups/:group_id

Get the account group detail.

Authorization: member admin app superadmin

POST accounts/:account_id/groups

Create an account group.

Authorization:

Attributes Type Authorization Description
name
required
string The group name
description
optional
string The group description.
default_bill_address_id
optional
null|string The default bill address of the user.
default_invoice_profile_id
optional
null|string The default invoice profile of the user.
supervisors
optional
array The group supervisors.
policies.hotels.active
optional
boolean The flag that indicates whether or not the hotels policy are active
policies.hotels.action
optional
string The configuration action to take if the policy of the hotels aren't respected.
policies.hotels.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in hotels vertical for personal bookings
policies.hotels.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.hotels.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in hotels vertical for business bookings
policies.hotels.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.hotels.max_stars
optional
null|number The group policy that define the max hotel stars.
policies.hotels.min_checkin_days
optional
null|number The group policy that define the minimum days before checkin.
policies.hotels.rate_per_night
optional
null|array The group policy that define the rate per night.
policies.hotels.rate_per_night_per_radius
optional
null|array The group policy that define the rate per night per radius.
policies.flights.active
optional
boolean The flag that indicates whether or not the flights policy are active
policies.flights.action
optional
string The configuration action to take if the policy of the flights aren't respected.
policies.flights.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in flights vertical for personal bookings
policies.flights.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.flights.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in flights vertical for business bookings
policies.flights.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.flights.min_departure_days
optional
null|number The group policy that define the minimum days before departure for a flight search.
policies.flights.max_cabin_class
optional
null|string The group policy that define the maximum level of cabin class allowed.
policies.flights.min_duration_per_cabin_class
optional
null|array The group policy that defines the minimum durations of the flight to be able to buy a fare in a given cabin class.
policies.flights.rate_per_trip
optional
null|array The group policy that define the rate per flight trip.
policies.flights.min_duration_per_rate_per_trip
optional
null|array Group policy that defines the minimum flight duration to be able to purchase a fare of a given price.
policies.flights.max_rate_per_period_and_itinerary
optional
null|array Group policy that defines the maximum flight amount for a trip in a period
policies.trains.active
optional
boolean The flag that indicates whether or not the trains policy are active
policies.trains.action
optional
string The configuration action to take if the policy of the trains aren't respected.
policies.trains.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in trains vertical for personal bookings
policies.trains.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.trains.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in trains vertical for business bookings
policies.trains.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.trains.min_departure_days
optional
null|number The group policy that define the minimum days before departure for a train search.
policies.trains.rate_per_trip
optional
null|array The group policy that define the rate per train trip.
policies.trains.max_rate_per_period_and_itinerary
optional
null|array Group policy that defines the maximum train ticket amount for a trip in a period
policies.cars.active
optional
boolean The flag that indicates whether or not the cars policy are active
policies.cars.action
optional
string The configuration action to take if the policies of the cars aren't respected.
policies.cars.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in cars vertical for personal bookings
policies.cars.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.cars.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in cars vertical for business bookings
policies.cars.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.cars.rate_per_rental
optional
null|array The group policy that define the rate per car rental.
policies.cars.min_pick_up_days
optional
null|number The group policy that define the minimum days before departure for a car search.
approval.workflow.id
optional
string The approval workflow id
approval.workflow.approval_steps
optional
array The intermediate steps of the approval workflow.
approval.workflow.finalize_step.users
optional
array The users that can finalize the booking.
approval.flights.active
optional
boolean The flag that indicates whether or not the flights approval is active
approval.trains.active
optional
boolean The flag that indicates whether or not the trains approval is active
approval.cars.active
optional
boolean The flag that indicates whether or not the cars approval is active
approval.hotels.active
optional
boolean The flag that indicates whether or not the hotels approval is active
approval.travel_requests.active
optional
boolean The flag that indicates whether or not the travel requests approval is active
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
UNAUTHORIZED_ENTITY_ACCESS You are not authorized to access, use or change the entity passed.
PUT accounts/:account_id/groups/:group_id

Update account group data.

Authorization:

Attributes Type Authorization Description
name
optional
string The group name
description
optional
string The group description
default_bill_address_id
optional
null|string The default bill address of the user.
default_invoice_profile_id
optional
null|string The default invoice profile of the user.
supervisors
optional
array The group supervisors.
policies.hotels.active
optional
boolean The flag that indicates whether or not the hotels policy are active
policies.hotels.max_stars
optional
number The group policy that define the max hotel stars.
policies.hotels.min_checkin_days
optional
number The group policy that define the minimum days before checkin.
policies.hotels.rate_per_night
optional
array The group policy that define the rate per night.
policies.hotels.rate_per_night_per_radius
optional
array The group policy that define the rate per night per radius.
policies.hotels.action
optional
string The configuration action to take if the policy of the hotels aren't respected.
policies.hotels.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in hotels vertical for personal bookings
policies.hotels.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.hotels.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in hotels vertical for business bookings
policies.hotels.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.flights.active
optional
boolean The flag that indicates whether or not the flights policy are active
policies.flights.min_departure_days
optional
number The group policy that define the minimum days before departure for a flight search.
policies.flights.max_cabin_class
optional
null|string The group policy that define the maximum level of cabin class allowed.
policies.flights.min_duration_per_cabin_class
optional
array The group policy that defines the minimum durations of the flight to be able to buy a fare in a given cabin class.
policies.flights.rate_per_trip
optional
array The group policy that define the rate per flight trip.
policies.flights.max_rate_per_period_and_itinerary
optional
array Group policy that defines the maximum flight amount for a trip in a period
policies.flights.min_duration_per_rate_per_trip
optional
array Group policy that defines the minimum flight duration to be able to purchase a fare of a given price.
policies.flights.action
optional
string The configuration action to take if the policy of the flights aren't respected.
policies.flights.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in flights vertical for personal bookings
policies.flights.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.flights.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in flights vertical for business bookings
policies.flights.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.trains.active
optional
boolean The flag that indicates whether or not the trains policy are active
policies.trains.min_departure_days
optional
number The group policy that define the minimum days before departure for a train search.
policies.trains.rate_per_trip
optional
array The group policy that define the rate per train trip.
policies.trains.action
optional
string The configuration action to take if the policy of the trains aren't respected.
policies.trains.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in trains vertical for personal bookings
policies.trains.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.trains.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in trains vertical for business bookings
policies.trains.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
policies.trains.max_rate_per_period_and_itinerary
optional
array Group policy that defines the maximum train ticket amount for a trip in a period
policies.cars.active
optional
boolean The flag that indicates whether or not the cars policy are active
policies.cars.rate_per_rental
optional
array The group policy that define the rate per car rental.
policies.cars.min_pick_up_days
optional
number The group policy that define the minimum days before the pick up for a car search.
policies.cars.action
optional
string The configuration action to take if the policy of the cars aren't respected.
policies.cars.addons.bizzyflex.personal.active
optional
boolean Enable BizzyFlex in cars vertical for personal bookings
policies.cars.addons.bizzyflex.personal.forced
optional
boolean Force BizzyFlex selection during checkout process for personal bookings
policies.cars.addons.bizzyflex.business.active
optional
boolean Enable BizzyFlex in cars vertical for business bookings
policies.cars.addons.bizzyflex.business.forced
optional
boolean Force BizzyFlex selection during checkout process for business bookings
approval.workflow.id
optional
string The approval workflow id
approval.workflow.approval_steps
optional
array The intermediate steps of the approval workflow.
approval.workflow.finalize_step.users
optional
array The users that can finalize the booking.
approval.flights.active
optional
boolean The flag that indicates whether or not the flights approval is active
approval.trains.active
optional
boolean The flag that indicates whether or not the trains approval is active
approval.cars.active
optional
boolean The flag that indicates whether or not the cars approval is active
approval.hotels.active
optional
boolean The flag that indicates whether or not the hotels approval is active
approval.travel_requests.active
optional
boolean The flag that indicates whether or not the travel requests approval is active
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST accounts/:account_id/groups/:group_id/associate

Associate users to a specific group.

Authorization:

Attributes Type Authorization Description
users_ids
required
array The group name
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE accounts/:account_id/groups/:group_id

Delete an account group.

Authorization:

Attributes Type Authorization Description
destinatary_group_id
optional
null|string The group id where to transfer eventually associated users of this group
GET accounts/:account_id/groups/:group_id/supervisors

Get all supervisors of an account

Authorization: admin app superadmin

POST airlines/:airline_id/upload-logo

Save airline logo

Authorization: admin app superadmin

Attributes Type Authorization Description
logo_square
optional
file The logo file
GET approval-workflows

Get the Approval Workflow list.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
account_id
optional
string Filter by account_id
name
optional
string Filter by key name
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET approval-workflows/:approvalworkflow_id

Get the Approval Workflow detail

Authorization:

POST approval-workflows

Add a new Approval Workflow

Authorization:

Attributes Type Authorization Description
name
required
string The name of the Workflow
account_id
optional
null|string The account where the Workflow will be visible. null indicates that is visible to ALL accounts
system
optional
boolean If true the Workflow cannot be deleted via API
price_tolerance_default
optional
number The name of the Workflow
is_message_required
optional
boolean if true, a message for supervisor is required
approval_steps
optional
array The Approval steps
finalize_step.price_tolerance_override
optional
boolean Tells if in this step the user can override the default price tolerance
allow_booking_owner
optional
boolean Tells if the booking owner can finalize the booking
PUT approval-workflows/:approval_workflow_id

Add a new Approval Workflow for the given account

Authorization:

Attributes Type Authorization Description
name
required
string The name of the Workflow
account_id
optional
null|string The account where the Workflow will be visible. null indicates that is visible to ALL accounts
is_message_required
optional
boolean if true, a message for supervisor is required
price_tolerance_default
required
string The name of the Workflow
approval_steps
optional
array The Approval steps
finalize_step.price_tolerance_override
optional
boolean Tells if in this step the user can override the default price tolerance
allow_booking_owner
optional
boolean Tells if the booking owner can finalize the booking
is_message_required
optional
boolean if true, a message for supervisor is required
DELETE approval-workflows/:approval_workflow_id

Delete an Approval Workflow for the given account

Authorization:

GET booking-snapshots

Filter Booking snapshots

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter snapshots by id
booking_model
optional
string Filter Snapshots by booking models
booking_id
optional
string Filter Snapshots by booking models
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST booking-snapshots

Create a new booking snapshot

Authorization:

Attributes Type Authorization Description
booking_model
optional
string The Mongoose model of the booking
booking_id
optional
string The Booking id
GET booking-snapshots/:booking_snapshot_id

Get a booking snapshot

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST booking-snapshots/:booking_snapshot_id/restore

Restore a booking snapshot

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET car-bookings

Get the full car bookings list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter car bookings by plan id.
id
optional
string Filter car bookings by id
has_extra_services
optional
boolean Filter car bookings by extra services.
extra_services
optional
array Filter car bookings by extra service type.
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
billing_address_id
optional
string Filter car bookings by billing address id
invoice_profile_id
optional
string Filter car bookings by invoice profile id
code
optional
string Filter car bookings by code
status
optional
string Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
cancelled_from
optional
string Filter car bookings by cancellation from
cancelled_to
optional
string Filter car bookings by cancellation to
pick_up_id
optional
string Filter car bookings by pick up id
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
string Filter car bookings by drivers
needs_approval
optional
boolean Filter car bookings by needs approval
is_policy_respected
optional
boolean Filter car bookings by policy respected
total_amount
optional
float Filter car bookings by total amount
invoice_ids
optional
string Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
string Return car bookings based on its invoicing status
is_personal
optional
boolean Filter car bookings by is personal
license_fee
optional
integer Filter car bookings by license fee
client_classification
optional
string Filter car bookings by client classification.
client_type
optional
string Filter car bookings by client type.
merchant
optional
string Filter car bookings by merchant
approver_id
optional
string Filter car bookings by approver_id.
account_id
optional
string Filter car bookings by account_id
account_ids
optional
array Filter car bookings by account_ids
exclude_account_ids
optional
array Filter car bookings by exclude account_ids
provider_code
optional
string Filter car bookings by provider_code
provider_key
optional
string Filter car bookings by provider key
payment_method
optional
string Filter car bookings by payment method
custom_fields
optional
string Custom fields
is_manual
optional
boolean Filter car bookings by manual creation
automatic_invoice
optional
boolean Filter car bookings if auto invoice is active or not
vendor_name
optional
string Filter car bookings by vendor
full_credit
optional
boolean Filter car bookings by full credit
version
optional
number Filter hotel bookings by version (1, 1.5 or 2)
payment_status
optional
string Filter hotel bookings by payment status (not_paid, partly_paid or paid)
is_negotiated
optional
boolean Filter car bookings if fare is negotiated or not
pnr
optional
string Filter car bookings by PNR field
GET car-bookings/my-account

Get the full car bookings list of an account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter car bookings by plan id.
id
optional
string Filter car bookings by id
has_extra_services
optional
boolean Filter car bookings by extra services.
extra_services
optional
array Filter car bookings by extra service type.
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
billing_address_id
optional
string Filter car bookings by billing address id
invoice_profile_id
optional
string Filter car bookings by invoice profile id
code
optional
string Filter car bookings by code
status
optional
string Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
cancelled_from
optional
string Filter car bookings by cancellation from
cancelled_to
optional
string Filter car bookings by cancellation to
pick_up_id
optional
string Filter car bookings by pick up id
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
string Filter car bookings by drivers
needs_approval
optional
boolean Filter car bookings by needs approval
is_policy_respected
optional
boolean Filter car bookings by policy respected
total_amount
optional
float Filter car bookings by total amount
invoice_ids
optional
string Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
string Return car bookings based on its invoicing status
is_personal
optional
boolean Filter car bookings by is personal
license_fee
optional
integer Filter car bookings by license fee
client_classification
optional
string Filter car bookings by client classification.
client_type
optional
string Filter car bookings by client type.
merchant
optional
string Filter car bookings by merchant
approver_id
optional
string Filter car bookings by approver_id.
account_id
optional
string superadmin Filter car bookings by account_id
GET car-bookings/drafts

Get Car Bookings in draft status

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
id
optional
string Filter car bookings by id
code
optional
string Filter car bookings by code
GET car-bookings/my-user

Get the full car bookings list of the session user.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter car bookings by plan id.
id
optional
string Filter car bookings by id
has_extra_services
optional
boolean Filter car bookings by extra services.
extra_services
optional
array Filter car bookings by extra service type.
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
billing_address_id
optional
string Filter car bookings by billing address id
invoice_profile_id
optional
string Filter car bookings by invoice profile id
code
optional
string Filter car bookings by code
status
optional
string Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
cancelled_from
optional
string Filter car bookings by cancellation from
cancelled_to
optional
string Filter car bookings by cancellation to
pick_up_id
optional
string Filter car bookings by pick up id
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
string Filter car bookings by drivers
needs_approval
optional
boolean Filter car bookings by needs approval
is_policy_respected
optional
boolean Filter car bookings by policy respected
total_amount
optional
float Filter car bookings by total amount
invoice_ids
optional
string Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
string Return car bookings based on its invoicing status
is_personal
optional
boolean Filter car bookings by is personal
license_fee
optional
integer Filter car bookings by license fee
client_classification
optional
string Filter car bookings by client classification.
client_type
optional
string Filter car bookings by client type.
merchant
optional
string Filter car bookings by merchant
approver_id
optional
string Filter car bookings by approver_id.
GET car-bookings/:car_booking_id

Get the booking detail.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
POST car-bookings/:car_booking_id/fetch

Fetch booking data from its provider.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
POST car-bookings

Create a car booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
user_id
optional
string superadmin The user_id (owner) of the context
fare_id
required
string The fare of the car selected by the customer.
drivers
required
array Drivers data.
phone
optional
string A phone contact for emergency reason.
notes
optional
string The notes of the booking.
flight_number
optional
string The flight number as arrival detail for the vendor.
arrival_details
optional
object arrival details for the vendor.
extra_services
optional
array The extra services and equipments selected by the customer.
request_services
optional
array The request services and equipments selected by the customer.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
payment.method
required
string The payment method.
payment.credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
payment.credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
is_personal
required
boolean Indicates if the booking is personal.
custom_fields
optional
object Object of custom fields
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
PUT car-bookings/:car_booking_id

Update a car booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
fare_id
optional
string A new booking rate id.
rate_price
optional
number superadmin Update the rate price.
rate_provider_price
optional
number superadmin Update the rate provider price.
issuing_fee
optional
number superadmin Update the rate issuing fee.
license_fee
optional
number superadmin Update the license fee.
pick_up
optional
object Object of the outbound cars with the index as a reference. Accepted fields for every car: pnr, departure_airport_terminal, arrival_airport_terminal.
drop_off
optional
object Object of the inbound cars with the index as a reference. Accepted fields for every car: pnr, departure_airport_terminal, arrival_airport_terminal.
pick_up_date
optional
string superadmin Update the pick up date.
drop_off_date
optional
string superadmin Update the drop off date.
holder_id
optional
string The holder id.
drivers
optional
object Object of the drivers data with the index as a reference. Accepted fields for every driver id, travel_document_id.
phone
optional
string The emergency phone of the booking.
status
optional
string superadmin The booking status.
provider_code
optional
string superadmin The provider code.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
is_vat_exempt
optional
boolean superadmin Update booking vat exempt flag
automatic_invoice
optional
boolean superadmin Define if the booking will be automatically invoices
inner_transactions
optional
array superadmin Update booking inner transactions
transaction_costs
optional
number superadmin Update the transaction costs.
invoice_id
optional
null|string superadmin Update the booking invoice.
provider_key
optional
string superadmin Update the provider key.
driver_birthday
optional
object superadmin Update driver birthday.
is_personal
optional
boolean superadmin Update the booking is_personal.
is_archived
optional
boolean superadmin Update the booking is_archived.
custom_fields
optional
object Object of custom fields
source
optional
string superadmin The booking source.
version
optional
number superadmin Update the version of the booking.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
MISSING_USER_INFO There are missing info to the user associated to a specific field.
MISSING_DOCUMENT Missing document for a specific passenger.
DOCUMENT_EXPIRATION_ISSUE The document you request is expired or will expire during the trip
INVALID_DOCUMENT_OWNER The document you passed does not belong to the passenger declared.
FARE_EXPIRED The fare you request is not anymore valid
POST car-bookings/:car_booking_id/initialize

Initialize a car booking creating the booking provider.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
FARE_EXPIRED The fare you request is not anymore valid
POST car-bookings/:car_booking_id/approve

Approve the current booking

Authorization:

Attributes Type Authorization Description
price_tolerance
optional
number
Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST car-bookings/:car_booking_id/reject

Reject booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST car-bookings/:car_booking_id/void

Void booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST car-bookings/:car_booking_id/trash

Trash booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST car-bookings/calculate-costs

Calculate costs of a car booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
car_booking_id
required if rate_id not filled
objectId The car booking id.
rate_id
required if booking_id not filled
string The rate of the car selected by the customer.
locale
optional
string The locale.
extra_services
optional
array Array of extra services and equipments selected by the customer.
request_services
optional
array Array of request services selected by the customer.
payment_method
optional
string The payment method.
billing_address_id
optional
string The billing address id
additional_driver_birthday
optional
string The birthday in format YYYY/MM/DD of the additional driver
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
is_personal
required
boolean Indicates if the booking is personal.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST car-bookings/generate-csv

Generate a csv file with the full car bookings list

Authorization: superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
code
optional
string Filter car bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
pick_up_id
optional
string Filter car bookings by pick up location
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
array Filter car bookings by guests
needs_approval
optional
boolean Filter car bookings by needs approval
invoice_ids
optional
array Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
array Return car bookings based on its invoicing status
invoice_profile_id
optional
string Filter car bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter car bookings by extra service type.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST car-bookings/my-account/generate-csv

Generate a csv file with the full car bookings list of an account

Authorization: admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
code
optional
string Filter car bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
pick_up_id
optional
string Filter car bookings by pick up location
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
array Filter car bookings by guests
needs_approval
optional
boolean Filter car bookings by needs approval
invoice_ids
optional
array Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
array Return car bookings based on its invoicing status
invoice_profile_id
optional
string Filter car bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter car bookings by extra service type.
account_id
optional
string superadmin Filter car bookings by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST car-bookings/my-user/generate-csv

Generate a csv file with the full car bookings list of an account

Authorization: member admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter car bookings by creator id
supervisor_id
optional
string Filter car bookings by supervisor id
code
optional
string Filter car bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter car bookings by status
created_from
optional
string Filter car bookings by creation from
created_to
optional
string Filter car bookings by creation to
updated_from
optional
string Filter car bookings by update from
updated_to
optional
string Filter car bookings by update to
pick_up_id
optional
string Filter car bookings by pick up location
pick_up_date_from
optional
string Filter car bookings by pick up date from
pick_up_date_to
optional
string Filter car bookings by pick up date to
traveller_ids
optional
array Filter car bookings by guests
needs_approval
optional
boolean Filter car bookings by needs approval
invoice_ids
optional
array Filter car bookings by invoice_id
is_invoiced
optional
boolean Return car bookings that are already invoiced
invoicing_status
optional
array Return car bookings based on its invoicing status
invoice_profile_id
optional
string Filter car bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter car bookings by extra service type.
is_personal
optional
boolean Filter hotel bookings by is_personal
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST car-bookings/:car_booking_id/initialize-payment

Initialize a payment

Authorization: member admin superadmin

Attributes Type Authorization Description
payment_method
required
string The payment method.
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
paypal_payment_id
required when payment_method = paypal
string [PayPal] the paypal payment_id.
paypal_payer_id
required when payment_method = paypal
string [PayPal] the paypal payer id.
change_payment_method
optional
boolean Flag that indicates if the action is used to initialize a new payment method.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
POST car-bookings/:car_booking_id/process

Process a car booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
transaction_id
optional
string The transaction_id to use in order to process this booking, not required for payment method === `postpay`
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST car-bookings/:car_booking_id/cancel

Cancel a confirmed booking.

Authorization:

Attributes Type Authorization Description
force
optional
string This parameter is used to force the booking into status Cancelled when SuperAdmin.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST car-bookings/:car_booking_id/complete-cancel

Complete an car booking cancellation.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST car-bookings/:car_booking_id/complete-process

Complete a car booking process.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET car-bookings/:car_booking_id/voucher

Get booking voucher

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
optional
string The language you want the voucher is generated
regenerate
optional
string This parameter force the system to regenerate the voucher
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST car-bookings/:car_booking_id/edit/price-changes

Adds new price change to a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference on the price change
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
GET car-bookings/:car_booking_id/edit/price-changes

Get booking price changes section

Authorization:

PUT car-bookings/:car_booking_id/edit/price-changes/:price_change_id

Updates a price change from a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference on the price change
amount
optional
The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
DELETE car-bookings/:car_booking_id/edit/price-changes/:price_change_id

Delete a price change from a booking

Authorization:

POST car-bookings/:car_booking_id/edit/price-changes/confirm

Confirm all price changes that are in draft status

Authorization:

POST car-bookings/:car_booking_id/edit/price-changes/discard

Discard all price changes that are in draft status

Authorization:

DELETE car-bookings/:car_booking_id

Delete booking (DRAFT) only

Authorization:

Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
NOT_FOUND The resource you are trying to get not exists.
POST car-bookings/create

Create booking from scratch

Authorization:

Attributes Type Authorization Description
provider_key
optional
string The provider key of the booking
provider_currency
optional
string The provider currency of the booking
merchant
optional
string The provider currency of the booking
account_id
optional
string The account_id of the booking
assigned_to
optional
string The superadmin assigned to the booking
user_id
optional
string The owner of the booking
is_personal
optional
boolean If true the booking was for personal purposes
POST car-bookings/:car_booking_id/duplicate

Duplicate a booking

Authorization:

Attributes Type Authorization Description
user_id
optional
string The owner of the booking
GET car-bookings/:car_booking_id/edit

Get booking for edit

Authorization:

PUT car-bookings/:car_booking_id/edit/rate

Update booking rate section

Authorization:

Attributes Type Authorization Description
rate
optional
object The rate of the booking
PUT car-bookings/:car_booking_id/edit/rate/product_info

Update booking rate section adding the product info file

Authorization:

Attributes Type Authorization Description
car_rental_company
required
string Car rental company id
product_info
required
file The product info of the car rental company
PUT car-bookings/:car_booking_id/edit/car

Update booking car section

Authorization:

Attributes Type Authorization Description
car
optional
object The car of the booking
PUT car-bookings/:car_booking_id/edit/drivers

Update booking drivers section

Authorization:

Attributes Type Authorization Description
drivers
optional
array Array with all drivers informations.
PUT car-bookings/:car_booking_id/edit/billing

Update booking billing section

Authorization:

Attributes Type Authorization Description
billing_address_id
optional
string The billing address id of the booking
invoice_profile_id
optional
string The invoice profile of the booking
automatic_invoice
optional
boolean The Flag of automatic invoice
PUT car-bookings/:car_booking_id/edit/general

Update booking general section

Authorization:

Attributes Type Authorization Description
holder_id
optional
string The holder of the booking
account_id
optional
string The account of the booking
pnr
optional
string The PNR of the booking
provider_code
optional
string The provider code of the booking
provider_key
optional
string The provider key of the booking
is_personal
optional
boolean If true the booking is for personal use
trip_id
optional
string The Trip associated to booking
checkin_email
optional
string The Check in Email associated to booking
phone
optional
string The Phone number associated to booking
PUT car-bookings/:car_booking_id/edit/status

Change status of the booking

Authorization:

Attributes Type Authorization Description
status
optional
string The new status of the booking
PUT car-bookings/:car_booking_id/edit/payment

Update booking payment section

Authorization:

Attributes Type Authorization Description
method
optional
string The method used for pay the booking
transaction_id
optional
string The transaction associated
card_id
optional
string The card id for the payment
card_owner
optional
string The card id for the payment
amount
optional
number The commission fee for the secured transaction
GET car-bookings/:car_booking_id/edit/validate

Validate full booking

Authorization:

GET car-bookings/:car_booking_id/edit/:section/validate

Validate booking section

Authorization:

GET car-bookings/:car_booking_id/edit/provider

Get booking directly from the provider

Authorization:

DELETE car-bookings/:car_booking_id/edit/rate/product_info

Remove booking rate section product info

Authorization:

GET cars/location

Get a car location entity

Authorization: member admin app superadmin

Attributes Type Authorization Description
id
optional
string The location id from the db _id
type
optional
string The location type airport or place
locale
optional
string The locale language you want the response in i.e en_us for american english
POST cars/fares/searches

Create a cars search fares session

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string The account_id context
search_solution_id
required
string A search solution id
GET cars/fares/searches/:search_id

Get Fare search result

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string The account_id context
POST cars/fares

POST for a single car Fares

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string The account_id context
search_fare_id
required
string A search fare id.
GET cars/fares/:fare_id

Get a single car Fares

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
account_id
required
string The account_id context
POST cars/charging-info

Returns the charging dates information

Authorization:

Attributes Type Authorization Description
fare_id
optional
string The rate id.
payment_method
optional
string The payment method.
GET company/suppliers

Get the company suppliers list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter suppliers by id
company
optional
string Filter suppliers by company
country
optional
string Filter suppliers by country
vat_number
optional
string Filter suppliers by vat number
tax_code
optional
string Filter suppliers by tax code
GET company/suppliers/:supplier_id

Get a company supplier details.

Authorization: superadmin

POST company/suppliers

Create a company supplier

Authorization: superadmin

Attributes Type Authorization Description
type
required
string The supplier company name
company
required
string The supplier company name
address
required
string The supplier address
city
required
string The supplier city
region
required
string The supplier state or the province
postal_code
required
string The supplier postal code
country
required
string The supplier country
vat_number
optional
string The supplier VAT number
tax_code
optional
string The supplier tax code if any
default_vat_code
optional
string The supplier default vat code
default_counterpart
optional
string The supplier default counterpart
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT company/suppliers/:supplier_id

Update a company supplier.

Authorization: superadmin

Attributes Type Authorization Description
type
optional
string The supplier company name
company
optional
string The supplier company name
address
optional
string The supplier address
city
optional
string The supplier city
region
optional
string The supplier state or the province
postal_code
optional
string The supplier postal code
country
optional
string The supplier country
vat_number
optional
string The supplier VAT number
tax_code
optional
string The supplier tax code if any
default_vat_code
optional
string The supplier default vat code
default_counterpart
optional
string The supplier default counterpart
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE company/suppliers/:supplier_id

Delete a company supplier.

Authorization: superadmin

GET company/payment-methods

Get the company payment methods list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
filter
optional
string A json format field for make any kind of request on the list
GET company/payment-methods/:payment_method_id

Get a company payment method details.

Authorization: superadmin

POST company/payment-methods

Create a company payment method

Authorization: superadmin

Attributes Type Authorization Description
name
required
string The payment method name
description
optional
string The payment method description
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT company/payment-methods/:payment_method_id

Update a company payment method.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string The payment method name
description
optional
string The payment method description
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE company/payment-methods/:payment_method_id

Delete a company payment method.

Authorization: superadmin

GET company/fiscal-documents

Get the company fiscal documents list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
id
optional
string Filter fiscal documents by id
supplier_id
optional
string Filter fiscal documents by account_id
type
optional
string Filter fiscal documents by type
number
optional
string Filter fiscal documents by number
created_from
optional
string Filter fiscal documents by creation from
created_to
optional
string Filter fiscal documents by creation to
issue_date_from
optional
string Filter fiscal documents by issued from
issue_date_to
optional
string Filter fiscal documents by issued to
is_paid
optional
boolean Filter paid fiscal documents
is_registered
optional
boolean Filter registered fiscal documents
total_invoice
optional
float Filter fiscal documents by total amount
payment_deadline_from
optional
string Filter fiscal documents by payment deadline from
payment_deadline_to
optional
string Filter fiscal documents by payment deadline to
payment_date_from
optional
string Filter fiscal documents by payment date from
payment_date_to
optional
string Filter fiscal documents by payment date to
GET company/fiscal-documents/:fiscal_document_id

Get a company fiscal document details.

Authorization: superadmin

POST company/fiscal-documents

Create a company fiscal document

Authorization: superadmin

Attributes Type Authorization Description
type
required
string The fiscal document type
number
required
string The fiscal document number
issue_date
required
string The fiscal document issue date
supplier_id
required
string The fiscal document supplier id
description
optional
string The fiscal document description
currency
required
string The fiscal document currency
total_taxable_income
required
float The fiscal document total taxable income
total_vat_amount
required
float The fiscal document total vat amount
total_withholding_amount
required
float The fiscal document total withholding amount
total_invoice
required
float The fiscal document total invoice
is_registered
optional
boolean The fiscal document is registered flag
is_paid
optional
boolean The fiscal document is paid flag
payment_method_id
optional
string The fiscal document payment method id
payment_ref
optional
string The fiscal document reference id
payment_date
optional
string The fiscal document payment date
payment_deadline
optional
string The fiscal document payment deadline
linked_invoices
optional
array The fiscal document linked invoice array
vat_code
optional
string The fiscal document vat code
counterpart
optional
string The fiscal document counterpart
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT company/fiscal-documents/:fiscal_document_id

Update a company fiscal document.

Authorization: superadmin

Attributes Type Authorization Description
type
required
string The fiscal document type
number
optional
string The fiscal document number
issue_date
optional
string The fiscal document issue date
supplier_id
optional
string The fiscal document supplier id
description
optional
string The fiscal document description
currency
optional
string The fiscal document currency
total_taxable_income
optional
float The fiscal document total taxable income
total_vat_amount
optional
float The fiscal document total vat amount
total_withholding_amount
optional
float The fiscal document total withholding amount
total_invoice
optional
float The fiscal document total invoice
is_registered
optional
boolean The fiscal document is registered flag
is_paid
optional
boolean The fiscal document is paid flag
payment_method_id
optional
string The fiscal document payment method id
payment_ref
optional
string The fiscal document reference id
payment_date
optional
null|string The fiscal document payment date
linked_invoices
optional
array The fiscal document linked invoice array
payment_deadline
optional
null|string The fiscal document payment deadline
vat_code
optional
string The fiscal document vat code
counterpart
optional
string The fiscal document counterpart
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST company/fiscal-documents/:fiscal_document_id/file

Add a company fiscal document file

Authorization: superadmin

Attributes Type Authorization Description
file
required
file The fiscal document file
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST company/fiscal-documents/export

Export fiscal documents

Authorization: superadmin

Attributes Type Authorization Description
type
optional
string Filter fiscal documents by type
created_from
optional
string Filter fiscal documents by creation from
created_to
optional
string Filter fiscal documents by creation to
issue_date_from
optional
string Filter fiscal documents by issued from
issue_date_to
optional
string Filter fiscal documents by issued to
supplier_id
optional
string Filter fiscal documents by supplier_id
is_paid
optional
boolean Filter paid fiscal documents
is_registered
optional
boolean Filter registered fiscal documents
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE company/fiscal-documents/:fiscal_document_id

Delete a company fiscal document

Authorization: superadmin

GET custom-fields

Get the custom field list account

Authorization: admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
account_id
optional
string Filter custom fields by account_id.
entity_types
optional
string Filter custom fields by entity types.
is_deleted
optional
boolean Filter custom fields by is_deleted false.
available_for_approval
optional
boolean Filter custom fields by available for approval.
name
optional
string Filter custom fields by name.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET custom-fields/:custom_fields_id

Get the custom field details

Authorization: admin superadmin

GET custom-fields/:custom_fields_id

Get the custom field details

Authorization: admin superadmin

DELETE custom-fields/:custom_fields_id

Set 'is_deleted' true on a giving custom fields

Authorization: admin superadmin

POST custom-fields

Create a single custom field.

Authorization: admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id of custom fields. Is required if i am a superadmin
name
required
string The name of custom fields.
type
required
string The type of custom fields.
key
optional
string The name convert in lowercase and without space
values
optional
array The values of single checkbox or select
position
required
number Position of custom field
entity_type
required
array the Entity type of custom field
is_deleted
optional
boolean check if custom field is deleted
roles
optional
array The roles that custom field is associated
is_csv_export
optional
boolean check if custom field exportabled
is_required
optional
boolean check if custom field is required
is_editable
optional
boolean check if custom field is editable by user
available_for_approval
optional
boolean check if custom field is available for approval
is_filterable
optional
boolean check if custom field is filterable
properties
optional
object Required custom field
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT custom-fields/:custom_fields_id

Update custom fields

Authorization: member admin superadmin

Attributes Type Authorization Description
descriptions.en_us
optional
string The description values for the locale en_us
descriptions.it_it
optional
string The description values for the locale it_it
descriptions.es_es
optional
string The description values for the locale es_es
descriptions.de_de
optional
string The description values for the locale de_de
descriptions.ru_ru
optional
string The description values for the locale ru_ru
descriptions.fr_fr
optional
string The description values for the locale fr_fr
descriptions.pt_pt
optional
string The description values for the locale pt_pt
descriptions.nl_nl
optional
string The description values for the locale nl_nl
name
optional
string The name of custom fields.
values
optional
array The values of single checkbox or select
position
optional
number Position of custom field
is_csv_export
optional
boolean Export Csv of custom field
is_filterable
optional
boolean Filtered of custom field
is_required
optional
boolean Required custom field
is_editable
optional
boolean Editable custom field
available_for_approval
optional
boolean check if custom field is available for approval
properties
optional
object Required custom field
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT custom-fields/update-entity/custom-fields

Update entity type custom fields

Authorization: member admin superadmin

Attributes Type Authorization Description
entity_type
required
string The name of the entity
entity_id
optional
string The ID of entity
custom_fields
optional
object Object of custom fields
GET extra-services

Get the full extra services list.

Authorization: superadmin

Attributes Type Authorization Description
category
optional
string Filter extra service by category.
type
optional
string Filter extra services by type.
is_active
optional
boolean Filter extra services by active flag.
is_deleted
optional
boolean Filter extra services by deleted flag.
accounts
optional
array Filter extra services by accounts.
GET extra-services/settings

Get full list of the manual extra services types.

Authorization: member admin superadmin

GET extra-services/types

Get full list of the extra services types.

Authorization: member admin superadmin

GET extra-services/:extra_service_id

Get the extra service details.

Authorization: member admin superadmin

POST extra-services

Create an extra service.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string The extra service name.
category
optional
string The extra service category.
type
optional
string The extra service type.
description
optional
object The extra service description.
is_active
optional
boolean Indicate if the extra services is currently active.
price
optional
null|number The extra service price.
currency
optional
null|string The extra service currency.
provider.price
optional
null|number The provider price.
provider.currency
optional
null|string The extra service provider currency.
max_quantity
optional
number Indicate the quantity of the extra service.
price_unit
optional
string Indicate if the extra service is applyed to all of the fare travellers or for one.
notes
optional
string The extra service note.
rules.included_accounts_ids
optional
array List of accounts that may be included from the service.
rules.excluded_accounts_ids
optional
array List of accounts that may be excluded from the service.
rules.included_providers_keys
optional
array List of providers keys that may be included from the service.
rules.excluded_providers_keys
optional
array List of providers keys that may be excluded from the service.
rules.min_purchase_hours
optional
number Indicate that when there are less than this number of hours to go until the departure, additional services cannot be ordered.
rules.price_calculation_ref
optional
string Value to consider for calculate the price of the extra service during all the itinerary.
rules.included_airline_ids
optional
array List of airlines that may be included from the service.
rules.excluded_airline_ids
optional
array List of airlines that may be excluded from the service.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT extra-services/:id

Update an extra services.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string The extra service name.
type
optional
string The extra service name.
description
optional
object The extra service description.
is_active
optional
boolean Indicate if the extra services is currently active.
price
optional
null|number The extra service price.
currency
optional
null|string The extra service currency.
provider.price
optional
number The provider price.
provider.currency
optional
null|string The extra service provider currency.
max_quantity
optional
number Indicate the quantity of the extra service.
price_unit
optional
string Indicate if the extra service is applyed to all of the fare travellers or for one.
notes
optional
string The extra service note.
rules.included_accounts_ids
optional
array List of accounts that may be included from the service.
rules.excluded_accounts_ids
optional
array List of accounts that may be excluded from the service.
rules.included_providers_keys
optional
array List of providers keys that may be included from the service.
rules.excluded_providers_keys
optional
array List of providers keys that may be excluded from the service.
rules.min_purchase_hours
optional
number Indicate that when there are less than this number of hours to go until the departure, additional services cannot be ordered.
rules.price_calculation_ref
optional
string Value to consider for calculate the price of the extra service during all the itinerary.
rules.included_airline_ids
optional
array List of airlines that may be included from the service.
rules.excluded_airline_ids
optional
array List of airlines that may be excluded from the service.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
DELETE extra-services/:id

Delete an extra service.

Authorization: superadmin

Errors codes
NOT_FOUND The resource you are trying to get not exists.
POST extra-services/add-to-booking

Add an extra service into an entity.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
category
optional
string The extra service category.
type
optional
string The extra service name.
status
optional
string The extra service status.
price
optional
null|number The extra service price.
currency
optional
null|string The extra service currency.
provider_price
optional
number The provider price.
provider_currency
optional
number The provider currency.
price_unit
optional
string Indicate if the extra service is applyed to all of the fare travellers or for one.
quantity
optional
number The quantity of the extra service.
description
optional
object The extra service description.
trips_ref
optional
array List of trips ref.
route
optional
string Indicates which route the extra service is associated with.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT extra-services/:id/update-to-booking

Update an extra service into an entity.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
category
optional
string The extra service category.
type
optional
string The extra service name.
quantity
optional
number The quantity of the extra service.
status
optional
string The extra service status.
price
optional
number The extra service price.
currency
optional
string The extra service currency.
provider_price
optional
number The provider price.
provider_currency
optional
string The provider currency.
price_unit
optional
string Indicate if the extra service is applyed to all of the fare travellers or for one.
transaction_id
optional
string The transaction id.
invoice_id
optional
null|string The invoice id.
trips_ref
optional
array List of trips ref .
route
optional
string Indicates which route the extra service is associated with.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/:id/delete-to-booking

Delete an extra service into an entity.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/send-email

Send the summary email of the extra service.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/initialize-payment

Initialize a manual extra services.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
extra_service_id
optional
string The entity id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/process

Process a manual extra services.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
extra_service_id
optional
string The extraservice id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/void

Void a manual extra services.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
extra_service_id
optional
string The extraservice id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST extra-services/void-payment

Void a manual extra service payment.

Authorization: superadmin

Attributes Type Authorization Description
entity_type
optional
string The entity type.
entity_id
optional
string The entity id.
extra_service_id
optional
string The extraservice id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST ext/flight-bookings/notify-event/:provider/:secure_key

[Call by provider] Notify a booking event

Authorization:

GET flight-bookings

Get the full flight bookings list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter flight bookings by plan id.
has_extra_services
optional
boolean Filter flight bookings by extra services.
extra_services
optional
array Filter flight bookings by extra service type.
id
optional
string Filter flight bookings by id
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
billing_address_id
optional
string Filter flight bookings by billing address id
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
code
optional
string Filter flight bookings by code
status
optional
string Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
cancelled_from
optional
string Filter flight bookings by cancellation from
cancelled_to
optional
string Filter flight bookings by cancellation to
departure_airport_id
optional
string Filter flight bookings by departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guests
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy respected
total_amount
optional
float Filter flight bookings by total amount
pnr
optional
string Filter flight bookings by flight pnr
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter flight bookings by is personal
merchant
optional
string Filter flight bookings by merchant
itinerary_type
optional
string Filter flight bookings by itinerary type
is_manual
optional
boolean Filter flight bookings by is manual
license_fee
optional
integer Filter flight bookings by license fee
client_classification
optional
string Filter flight bookings by client classification.
client_type
optional
string Filter flight bookings by client type.
approver_id
optional
string Filter flight bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter flight bookings by is_vat_recovery_eligible.
account_id
optional
string Filter flight bookings by account_id
account_ids
optional
array Filter flight bookings by account_ids
exclude_account_ids
optional
array Filter flight bookings by exclude account_ids
provider_code
optional
string Filter flight bookings by provider code
provider_key
optional
string Filter flight bookings by provider key
post_confirmation_status
optional
string Filter flight bookings by the status of the post_confirmation property
bizzyflex_statuses
optional
string Filter flight bookings by bizzyflex status
payment_method
optional
string Filter flight bookings by payment method
custom_fields
optional
string Custom fields
airlines
optional
string Filter flight bookings that contains at least one airline. Format should be all ids separated by ,
automatic_invoice
optional
boolean Filter flight bookings if auto invoice is active or not
version
optional
number Filter flight bookings by version (1, 1.5 or 2)
payment_status
optional
string Filter flight bookings by payment status (not_paid, partly_paid or paid)
is_negotiated
optional
boolean Filter flight bookings if fare is negotiated or not
GET flight-bookings/my-account

Get the full flight bookings list of an account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter flight bookings by plan id.
has_extra_services
optional
boolean Filter flight bookings by extra services.
extra_services
optional
array Filter flight bookings by extra service type.
id
optional
string Filter flight bookings by id
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
billing_address_id
optional
string Filter flight bookings by billing address id
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
code
optional
string Filter flight bookings by code
status
optional
string Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
cancelled_from
optional
string Filter flight bookings by cancellation from
cancelled_to
optional
string Filter flight bookings by cancellation to
departure_airport_id
optional
string Filter flight bookings by departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guests
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy respected
total_amount
optional
float Filter flight bookings by total amount
pnr
optional
string Filter flight bookings by flight pnr
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter flight bookings by is personal
merchant
optional
string Filter flight bookings by merchant
itinerary_type
optional
string Filter flight bookings by itinerary type
is_manual
optional
boolean Filter flight bookings by is manual
license_fee
optional
integer Filter flight bookings by license fee
client_classification
optional
string Filter flight bookings by client classification.
client_type
optional
string Filter flight bookings by client type.
approver_id
optional
string Filter flight bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter flight bookings by is_vat_recovery_eligible.
account_id
optional
string superadmin Filter flight bookings by account_id
GET flight-bookings/drafts

Get Flight Bookings in draft status

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
id
optional
string Filter flight bookings by id
code
optional
string Filter flight bookings by code
GET flight-bookings/my-user

Get the full flight bookings list of the session user.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter flight bookings by plan id.
has_extra_services
optional
boolean Filter flight bookings by extra services.
extra_services
optional
array Filter flight bookings by extra service type.
id
optional
string Filter flight bookings by id
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
billing_address_id
optional
string Filter flight bookings by billing address id
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
code
optional
string Filter flight bookings by code
status
optional
string Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
cancelled_from
optional
string Filter flight bookings by cancellation from
cancelled_to
optional
string Filter flight bookings by cancellation to
departure_airport_id
optional
string Filter flight bookings by departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guests
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy respected
total_amount
optional
float Filter flight bookings by total amount
pnr
optional
string Filter flight bookings by flight pnr
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter flight bookings by is personal
merchant
optional
string Filter flight bookings by merchant
itinerary_type
optional
string Filter flight bookings by itinerary type
is_manual
optional
boolean Filter flight bookings by is manual
license_fee
optional
integer Filter flight bookings by license fee
client_classification
optional
string Filter flight bookings by client classification.
client_type
optional
string Filter flight bookings by client type.
approver_id
optional
string Filter flight bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter flight bookings by is_vat_recovery_eligible.
GET flight-bookings/:flight_booking_id

Get the booking detail.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
GET flight-bookings/:flight_booking_id/rules

Get the booking detail.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
POST flight-bookings/calculate-costs

Calculate costs of a flight booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
flight_booking_id
required if fare_id not filled
string The flight booking id.
fare_id
required if flight_booking_id not filled
string The fare selected by the customer.
extra_baggages
required if flight_booking_id not filled
array Extra baggages selected by the customer.
extra_services
required if flight_booking_id not filled
array Extra services selected by the customer.
insurance_quotes
required if flight_booking_id not filled
array Insurances selected by the customer.
quote
optional
boolean True if there is the need to generate insurance quotes
locale
required
string The locale.
payment_method
optional
string The payment method.
billing_address_id
optional
string The billing address id
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
is_personal
required
boolean Indicates if the booking is personal.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
FARE_EXPIRED The fare you request is not anymore valid
POST flight-bookings/generate-csv

Generate a csv file with the full flight bookings list

Authorization: superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
code
optional
string Filter flight bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
departure_airport_id
optional
string Filter flight bookings by outbound departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guets
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy compliance
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
array Return flight bookings based on its invoicing status
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
itinerary_type
optional
string Filter flight bookings by itinerary type
custom_fields
optional
string Custom fields
extra_services
optional
array Filter flight bookings by extra service type.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST flight-bookings/my-account/generate-csv

Generate a csv file with the full flight bookings list of an account

Authorization: admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
code
optional
string Filter flight bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
departure_airport_id
optional
string Filter flight bookings by outbound departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guets
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy compliance
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
array Return flight bookings based on its invoicing status
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
itinerary_type
optional
string Filter flight bookings by itinerary type
custom_fields
optional
string Custom fields
extra_services
optional
array Filter flight bookings by extra service type.
account_id
optional
string superadmin Filter flight bookings by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST flight-bookings/my-user/generate-csv

Generate a csv file with the full flight bookings list of an user

Authorization: member admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter flight bookings by creator id
supervisor_id
optional
string Filter flight bookings by supervisor id
code
optional
string Filter flight bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter flight bookings by status
created_from
optional
string Filter flight bookings by creation from
created_to
optional
string Filter flight bookings by creation to
updated_from
optional
string Filter flight bookings by update from
updated_to
optional
string Filter flight bookings by update to
departure_airport_id
optional
string Filter flight bookings by outbound departure airport
departure_date_from
optional
string Filter flight bookings by departure date from
departure_date_to
optional
string Filter flight bookings by departure date to
traveller_ids
optional
array Filter flight bookings by guets
needs_approval
optional
boolean Filter flight bookings by needs approval
is_policy_respected
optional
boolean Filter flight bookings by policy compliance
invoice_ids
optional
string Filter flight bookings by invoice_id
invoicing_status
optional
array Return flight bookings based on its invoicing status
invoice_profile_id
optional
string Filter flight bookings by invoice profile id
itinerary_type
optional
string Filter flight bookings by itinerary type
custom_fields
optional
string Custom fields
extra_services
optional
array Filter flight bookings by extra service type.
is_personal
optional
boolean Filter flight bookings by is_personal
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST flight-bookings

Create a booking

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
user_id
optional
string superadmin The user_id (owner) of the context
fare_id
required
string The fare id selected by the customer
extra_baggages
optional
array Extra baggages selected by the customer.
extra_services
optional
array Extra services selected by the customer.
holder_id
optional
string The id of the passenger selected by the customer as the booking holder.
passengers
required
array Array with all passengers informations.
phone
required
string The phone number of the booking.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
airline_terms_accepted
optional
boolean Define if the user has accepted the airline terms
is_personal
required
boolean Indicates if the booking is personal.
custom_fields
optional
object Object of custom fields
payment.method
required
string The payment method.
payment.credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
payment.credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
approval_message
Required if approval workflow has is_message_required
string A message to send to the supervisor
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
MISSING_USER_INFO There are missing info to the user associated to a specific field.
MISSING_DOCUMENT Missing document for a specific passenger.
DOCUMENT_EXPIRATION_ISSUE The document you request is expired or will expire during the trip
INVALID_DOCUMENT_OWNER The document you passed does not belong to the passenger declared.
WRONG_PASSENGER_AGE Wrong passenger age.
NO_MIN_SINGLE_PAX_AGE No minimum single passenger age.
DUPLICATE_BOOKING Possible duplicate booking.
PUT flight-bookings/:flight_booking_id

Update a flight booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
fare_id
optional
null|string A new booking fare id.
holder_id
optional
string The holder id.
passengers
optional
array Array with all passengers informations.
extra_baggages
optional
array Extra baggages selected by the customer.
extra_services
optional
array Extra services selected by the customer.
phone
optional
string The emergency phone of the booking.
checkin_email
optional
string The email necessary for the checkin.
legs
optional
object Object of the legs with the id as a reference. Accepted fields for every flight: pnr, departure_airport_terminal, arrival_airport_terminal, login.url, login.username, login.password, cabin_class.
status
optional
string superadmin The booking status.
provider_code
optional
string superadmin The provider code.
source
optional
string superadmin The booking source.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
is_vat_exempt
optional
boolean superadmin Update booking vat exempt flag
automatic_invoice
optional
boolean superadmin Define if the booking will be automatically invoices
inner_transactions
optional
array superadmin Update booking inner transactions
transaction_costs
optional
number superadmin Update the transaction costs.
invoice_id
optional
null|string superadmin Update the booking invoice.
fare_price
optional
number superadmin Update the booking fare price.
fare_provider_price
optional
number superadmin Update the fare provider price.
issuing_fee
optional
number superadmin Update the fare issuing fee
provider_key
optional
string superadmin Update the provider key.
passenger_birthday
optional
object superadmin Update passenger birthday.
cabin_class
optional
object superadmin Update cabin class.
airline_number
optional
object superadmin Update airline number.
airline_operator_number
optional
object superadmin Update airline operator number.
airline_id
optional
object superadmin Update airline id.
operator_airline_id
optional
object superadmin Update operator airline id.
datetime
optional
object superadmin Update departure / arrival datetime.
is_personal
optional
boolean superadmin Update the booking is_personal.
is_archived
optional
boolean superadmin Update the booking is_archived.
custom_fields
optional
object Object of custom fields
license_fee
optional
number superadmin Update the licence fee.
version
optional
number superadmin Update the version of the booking.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
MISSING_USER_INFO There are missing info to the user associated to a specific field.
MISSING_DOCUMENT Missing document for a specific passenger.
DOCUMENT_EXPIRATION_ISSUE The document you request is expired or will expire during the trip
INVALID_DOCUMENT_OWNER The document you passed does not belong to the passenger declared.
POST flight-bookings/:flight_booking_id/initialize

Initialize a flight booking creating the booking provider.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
FARE_EXPIRED The fare you request is not anymore valid
DUPLICATE_BOOKING Possible duplicate booking.
POST flight-bookings/:flight_booking_id/lock-fare

Block a flight booking creating the booking provider.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
FARE_EXPIRED The fare you request is not anymore valid
DUPLICATE_BOOKING Possible duplicate booking.
POST flight-bookings/:flight_booking_id/approve

Approve the current booking

Authorization:

Attributes Type Authorization Description
price_tolerance
optional
number
Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST flight-bookings/:flight_booking_id/reject

Reject booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST flight-bookings/:flight_booking_id/void

Void booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST flight-bookings/:flight_booking_id/trash

Trash booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST flight-bookings/:flight_booking_id/discard

Discard booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST flight-bookings/:flight_booking_id/process

Process a flight booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
FARE_EXPIRED The fare you request is not anymore valid
PROVIDER_ERROR There was an issue with our provider. This can be a temporary problem. Please, retry in a few moments..
POST flight-bookings/:flight_booking_id/complete-process

Complete a flight booking process.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET flight-bookings/:flight_booking_id/ticket

Get booking ticket

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
optional
string The language you want the ticket is generated
regenerate
optional
string This parameter force the system to regenerate the ticket
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST flight-bookings/:flight_booking_id/initialize-payment

Initialize a payment

Authorization: member admin superadmin

Attributes Type Authorization Description
payment_method
required
string The payment method.
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
paypal_payment_id
required when payment_method = paypal
string [PayPal] the paypal payment_id.
paypal_payer_id
required when payment_method = paypal
string [PayPal] the paypal payer id.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
GET flight-bookings/:flight_booking_id/update

Get booking update

Authorization: member admin superadmin

Errors codes
PROVIDER_ERROR There was an issue with our provider. This can be a temporary problem. Please, retry in a few moments..
DELETE flight-bookings/:flight_booking_id

Delete booking (DRAFT) only

Authorization: superadmin

Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
NOT_FOUND The resource you are trying to get not exists.
POST flight-bookings/:flight_booking_id/edit/price-changes

Adds new price change to a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
GET flight-bookings/:flight_booking_id/edit/price-changes

Get booking price changes section

Authorization:

PUT flight-bookings/:flight_booking_id/edit/price-changes/:price_change_id

Updates a price change from a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
POST flight-bookings/:flight_booking_id/edit/price-changes/confirm

Confirm all price changes that are in draft status

Authorization:

POST flight-bookings/:flight_booking_id/edit/price-changes/discard

Discard all price changes that are in draft status

Authorization:

POST download/:entity/:id

Download entity json

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST emit-platform-update

Authorization: member admin app superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET places/:place_id

Get details of a place

Authorization: member admin app superadmin

Attributes Type Authorization Description
locale
required
string The locale for search the term
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET places

Get places list

Authorization: member admin app superadmin

Attributes Type Authorization Description
locale
required
string The locale for search the term
input
required
string The input for search places
types
optional
string The type to filter google places autocomplete API
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET locales

Get list of supported locales

Authorization: guest member admin app superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET countries

Get list of supported countries

Authorization: guest member admin app superadmin

Attributes Type Authorization Description
locale
optional
string The locale
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET provinces

Get list of italian provinces

Authorization: guest member admin app superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET countries/settings

Get countries settings

Authorization: guest member admin app superadmin

Attributes Type Authorization Description
locale
optional
string The locale
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET zones

Get list of supported zones

Authorization: guest member admin app superadmin

Attributes Type Authorization Description
locale
optional
string The locale
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET currencies/conversion-rates

Get currencies conversion rates

Authorization: guest member admin app superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET internal-notifications

Get the internal notifications list.

Authorization: guest member admin app superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET notifications-available

Returns a list of available notifications where extra email addresses can be subscribed to

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string Language return of the label values
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET ready

Get core health status

Authorization:

GET assets/:id

Generates the signed url from the given asset path.

Authorization:

GET hotel-bookings

Get the full hotel bookings list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter hotel bookings by plan id.
has_extra_services
optional
boolean Filter hotel bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter hotel bookings by id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
billing_address_id
optional
string Filter hotel bookings by billing address id
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
code
optional
string Filter hotel bookings by code
status
optional
string Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
cancelled_from
optional
string Filter hotel bookings by cancellation from
cancelled_to
optional
string Filter hotel bookings by cancellation to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
check_out_from
optional
string Filter hotel bookings by checkout to
check_out_to
optional
string Filter hotel bookings by checkout to
traveller_ids
optional
string Filter hotel bookings by guests
hotel_id
optional
string Filter hotel bookings by hotel_id
is_verified
optional
boolean Filter hotel bookings by verified
is_verification_email_sent
optional
boolean Filter hotel bookings by verification email sent
is_reconciled
optional
boolean Filter for hotel custom rate booking that have been reconciled or not
payment_info_sent
optional
boolean Filter for hotel custom rate booking that have been sent payment info or not to hotel
needs_approval
optional
boolean Filter hotel bookings by needs approval
is_policy_respected
optional
boolean Filter hotel bookings by policy respected
total_amount
optional
float Filter hotel bookings by total amount
invoice_ids
optional
string Filter hotel bookings by invoice ids
invoicing_status
optional
string Return flight bookings based on its invoicing status
merchant
optional
string Filter hotel bookings by merchant
is_refunded
optional
boolean Filter hotel bookings for which a refund must be made.
payment_method_required
optional
boolean Filter hotel reservations that need a credit card to be finalized
is_personal
optional
boolean Filter hotel bookings by is_personal
is_manual
optional
boolean Filter hotel bookings by is_manual
license_fee
optional
integer Filter hotel bookings by license fee
client_classification
optional
string Filter hotel bookings by client classification.
client_type
optional
string Filter hotel bookings by client type.
approver_id
optional
string Filter hotel bookings by approver_id.
negotiated
optional
string Filter hotel bookings rate type
account_id
optional
string Filter hotel bookings by account_id
account_ids
optional
array Filter hotel bookings by account_ids
exclude_account_ids
optional
array Filter hotel bookings by exclude account_ids
provider_code
optional
string Filter hotel bookings by provider_code
provider_key
optional
string Filter hotel bookings by provider key
bizzyflex_statuses
optional
string Filter flight bookings by bizzyflex status
has_market_price
optional
boolean Return hotel bookings that have market price
has_confirmation_number
optional
boolean Return hotel bookings that have hotel confirmation number
is_refundable
optional
boolean Filter hotel bookings by Cancellation Policy.
payment_method
optional
string Filter hotel bookings by payment method
custom_fields
optional
string Custom fields
automatic_invoice
optional
boolean Filter hotel bookings if auto invoice is active or not
version
optional
number Filter hotel bookings by version (1, 1.5 or 2)
payment_status
optional
string Filter hotel bookings by payment status (not_paid, partly_paid or paid)
GET hotel-bookings/my-account

Get the full hotel bookings list of an account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter hotel bookings by plan id.
has_extra_services
optional
boolean Filter hotel bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter hotel bookings by id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
billing_address_id
optional
string Filter hotel bookings by billing address id
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
code
optional
string Filter hotel bookings by code
status
optional
string Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
cancelled_from
optional
string Filter hotel bookings by cancellation from
cancelled_to
optional
string Filter hotel bookings by cancellation to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
check_out_from
optional
string Filter hotel bookings by checkout to
check_out_to
optional
string Filter hotel bookings by checkout to
traveller_ids
optional
string Filter hotel bookings by guests
hotel_id
optional
string Filter hotel bookings by hotel_id
is_verified
optional
boolean Filter hotel bookings by verified
is_verification_email_sent
optional
boolean Filter hotel bookings by verification email sent
is_reconciled
optional
boolean Filter for hotel custom rate booking that have been reconciled or not
payment_info_sent
optional
boolean Filter for hotel custom rate booking that have been sent payment info or not to hotel
needs_approval
optional
boolean Filter hotel bookings by needs approval
is_policy_respected
optional
boolean Filter hotel bookings by policy respected
total_amount
optional
float Filter hotel bookings by total amount
invoice_ids
optional
string Filter hotel bookings by invoice ids
invoicing_status
optional
string Return flight bookings based on its invoicing status
merchant
optional
string Filter hotel bookings by merchant
is_refunded
optional
boolean Filter hotel bookings for which a refund must be made.
payment_method_required
optional
boolean Filter hotel reservations that need a credit card to be finalized
is_personal
optional
boolean Filter hotel bookings by is_personal
is_manual
optional
boolean Filter hotel bookings by is_manual
license_fee
optional
integer Filter hotel bookings by license fee
client_classification
optional
string Filter hotel bookings by client classification.
client_type
optional
string Filter hotel bookings by client type.
approver_id
optional
string Filter hotel bookings by approver_id.
negotiated
optional
string Filter hotel bookings rate type
account_id
optional
string superadmin Filter hotel bookings by account_id
is_negotiated
optional
boolean Filter hotel bookings by custom rate
GET hotel-bookings/drafts

Get Hotel Bookings in draft status

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
id
optional
string Filter hotel bookings by id
code
optional
string Filter hotel bookings by code
GET hotel-bookings/my-user

Get the hotel bookings list of the session user.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter hotel bookings by plan id.
has_extra_services
optional
boolean Filter hotel bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter hotel bookings by id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
billing_address_id
optional
string Filter hotel bookings by billing address id
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
code
optional
string Filter hotel bookings by code
status
optional
string Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
cancelled_from
optional
string Filter hotel bookings by cancellation from
cancelled_to
optional
string Filter hotel bookings by cancellation to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
check_out_from
optional
string Filter hotel bookings by checkout to
check_out_to
optional
string Filter hotel bookings by checkout to
traveller_ids
optional
string Filter hotel bookings by guests
hotel_id
optional
string Filter hotel bookings by hotel_id
is_verified
optional
boolean Filter hotel bookings by verified
is_verification_email_sent
optional
boolean Filter hotel bookings by verification email sent
is_reconciled
optional
boolean Filter for hotel custom rate booking that have been reconciled or not
payment_info_sent
optional
boolean Filter for hotel custom rate booking that have been sent payment info or not to hotel
needs_approval
optional
boolean Filter hotel bookings by needs approval
is_policy_respected
optional
boolean Filter hotel bookings by policy respected
total_amount
optional
float Filter hotel bookings by total amount
invoice_ids
optional
string Filter hotel bookings by invoice ids
invoicing_status
optional
string Return flight bookings based on its invoicing status
merchant
optional
string Filter hotel bookings by merchant
is_refunded
optional
boolean Filter hotel bookings for which a refund must be made.
payment_method_required
optional
boolean Filter hotel reservations that need a credit card to be finalized
is_personal
optional
boolean Filter hotel bookings by is_personal
is_manual
optional
boolean Filter hotel bookings by is_manual
license_fee
optional
integer Filter hotel bookings by license fee
client_classification
optional
string Filter hotel bookings by client classification.
client_type
optional
string Filter hotel bookings by client type.
approver_id
optional
string Filter hotel bookings by approver_id.
negotiated
optional
string Filter hotel bookings rate type
GET hotel-bookings/stats

Get hotel bookings stat.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
account_id
optional
string superadmin Filter hotel bookings by account_id
status
optional
string Filter invoices by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
hotel_id
optional
string Filter hotel bookings by hotel_id
creator_id
optional
string Filter hotel bookings by creator id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotel-bookings/:hotel_booking_id

Get the booking detail.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale.
POST hotel-bookings/calculate-costs

Calculate costs of a hotel booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
hotel_booking_id
required if fare_id not filled
string The hotel booking id.
fare_id
required if booking_id not filled
string The fare of the hotel selected by the customer.
insurance_quotes
required if flight_booking_id not filled
array Insurances selected by the customer.
quote
optional
boolean True if there is the need to generate insurance quotes
locale
required
string The locale.
payment_method
optional
string The payment method.
billing_address_id
optional
string The billing address id
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
is_personal
required
boolean Indicates if the booking is personal.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST hotel-bookings/generate-csv

Generate a csv file with the full hotel bookings list

Authorization: superadmin

Attributes Type Authorization Description
locale
optional
string The locale for the language of the results contents.
account_id
optional
string superadmin Filter hotel bookings by account_id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
code
optional
string Filter hotel bookings by code
status
optional
array Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
hotel_id
optional
string Filter hotel bookings by hotel_id
traveller_ids
optional
array Filter hotel bookings by guets
needs_approval
optional
boolean Filter hotel bookings by needs approval
invoice_ids
optional
string Filter hotel bookings by invoice_id
invoicing_status
optional
array Return hotel bookings based on its invoicing status
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter hotel bookings by extra service type.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST hotel-bookings/my-account/generate-csv

Generate a csv file with the full hotel bookings list of an account

Authorization: admin superadmin

Attributes Type Authorization Description
locale
optional
string The locale for the language of the results contents.
account_id
optional
string superadmin Filter hotel bookings by account_id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
code
optional
string Filter hotel bookings by code
status
optional
array Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
hotel_id
optional
string Filter hotel bookings by hotel_id
traveller_ids
optional
array Filter hotel bookings by guets
needs_approval
optional
boolean Filter hotel bookings by needs approval
invoice_ids
optional
string Filter hotel bookings by invoice_id
invoicing_status
optional
array Return hotel bookings based on its invoicing status
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter hotel bookings by extra service type.
account_id
optional
string superadmin Filter hotel bookings by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST hotel-bookings/my-user/generate-csv

Generate a csv file with the full hotel bookings list of an account

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
optional
string The locale for the language of the results contents.
account_id
optional
string superadmin Filter hotel bookings by account_id
creator_id
optional
string Filter hotel bookings by creator id
supervisor_id
optional
string Filter hotel bookings by supervisor id
code
optional
string Filter hotel bookings by code
status
optional
array Filter hotel bookings by status
created_from
optional
string Filter hotel bookings by creation from
created_to
optional
string Filter hotel bookings by creation to
updated_from
optional
string Filter hotel bookings by update from
updated_to
optional
string Filter hotel bookings by update to
check_in_from
optional
string Filter hotel bookings by checkin from
check_in_to
optional
string Filter hotel bookings by checkin to
hotel_id
optional
string Filter hotel bookings by hotel_id
traveller_ids
optional
array Filter hotel bookings by guets
needs_approval
optional
boolean Filter hotel bookings by needs approval
invoice_ids
optional
string Filter hotel bookings by invoice_id
invoicing_status
optional
array Return hotel bookings based on its invoicing status
invoice_profile_id
optional
string Filter hotel bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter hotel bookings by extra service type.
is_personal
optional
boolean Filter hotel bookings by is_personal
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST hotel-bookings

Create an hotel booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
user_id
optional
string superadmin The user_id (owner) of the context
fare_id
required
string The fare of the hotel selected by the customer.
holder_id
optional
string The id of the guest selected by the customer as the booking holder.
rooms
required
array The array of the rooms with this format { adults: [USER_ID], children: [USER_ID] }.
phone
optional
string A phone contact for emergency reason.
notes
optional
string The notes of the booking.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
booker_address.address
optional
string The address of the booker.
booker_address.postal_code
optional
string The address of the booker.
booker_address.city
optional
string The city of the booker.
is_personal
required
boolean Indicates if the booking is personal.
custom_fields
optional
object Object of custom fields
payment.method
required
string The payment method.
payment.credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
payment.credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
PUT hotel-bookings/:hotel_booking_id

Update a booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account id context.
fare_id
optional
string A new booking fare id.
rate_price
optional
number superadmin Update the rate price.
issuing_fee
optional
number superadmin Update the rate issuing fee.
rate_provider_price
optional
number superadmin Update the rate provider price.
estimated_total_price
optional
number superadmin Update the estimated total price.
check_in
optional
string superadmin Update the check in date
check_out
optional
string superadmin Update the check out date
holder_id
optional
string The holder id.
rooms
optional
array The array of the rooms with this format { adults: [USER_ID], children: [USER_ID] }.
phone
optional
string The emergency phone of the booking.
notes
optional
string The notes of the passenger.
billing_address_id
optional
string The billing address id.
billing_address_project
optional
string The project for the billing address.
invoice_profile_id
optional
string The invoice profile id.
is_vat_exempt
optional
boolean superadmin Update booking vat exempt flag
status
optional
string superadmin The booking status.
market_price
optional
string superadmin The booking market price.
provider_code
optional
string superadmin The provider code.
is_verified
optional
boolean superadmin Define if the booking is verified
is_archived
optional
boolean superadmin Update the booking is archived
is_verification_email_sent
optional
boolean superadmin Define if the email is sent.
is_reconciled
optional
boolean superadmin Define if the hotel booking custom rate has been reconciled.
payment_info_sent
optional
boolean superadmin Define if the info payment for hotel custom rate has been sent to hotel.
automatic_invoice
optional
boolean superadmin Define if the booking will be automatically invoices
inner_transactions
optional
array superadmin Update booking inner transactions
transaction_costs
optional
number superadmin Update the transaction costs.
invoice_id
optional
null|string superadmin Update the booking invoice.
rate.source.code
optional
string superadmin Update the booking reservation id.
rate.source.pin
optional
string superadmin Update the booking PIN.
is_refunded
optional
boolean superadmin Update the booking is_refunded.
is_personal
optional
boolean superadmin Update the booking is_personal.
provider_key
optional
string superadmin Update the provider key.
rate_type
optional
string superadmin Update the booking board type.
room_to_delete
optional
number superadmin Index of the room to delete.
custom_fields
optional
object Object of custom fields
source
optional
string superadmin The booking source.
license_fee
optional
number superadmin Update the licence fee.
version
optional
number superadmin Update the version of the booking.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-bookings/:hotel_booking_id/initialize

Initialize an hotel booking creating the booking provider.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST hotel-bookings/:hotel_booking_id/approve

Approve the current booking

Authorization:

Attributes Type Authorization Description
price_tolerance
optional
number
Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST hotel-bookings/:hotel_booking_id/reject

Reject booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST hotel-bookings/:hotel_booking_id/void

Void booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST hotel-bookings/:hotel_booking_id/trash

Trash booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST hotel-bookings/:hotel_booking_id/process

Process an hotel booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
transaction_id
optional
string The transaction_id to use in order to process this booking, not required for payment method === `postpay`
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotel-bookings/:hotel_booking_id/complete-process

Complete an hotel booking process.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotel-bookings/:hotel_booking_id/cancel

Cancel a confirmed booking.

Authorization:

Attributes Type Authorization Description
force
optional
string This parameter is used to force the booking into status Cancelled when SuperAdmin.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotel-bookings/:hotel_booking_id/complete-cancel

Complete an hotel booking cancellation.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotel-bookings/:hotel_booking_id/voucher

Get booking voucher

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
optional
string The language you want the voucher is generated
regenerate
optional
string This parameter force the system to regenerate the voucher
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotel-bookings/:hotel_booking_id/initialize-payment

Initialize a payment

Authorization: member admin superadmin

Attributes Type Authorization Description
payment_method
required
string The payment method.
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
paypal_payment_id
required when payment_method = paypal
string [PayPal] the paypal payment_id.
paypal_payer_id
required when payment_method = paypal
string [PayPal] the paypal payer id.
change_payment_method
optional
boolean Flag that indicates if the action is used to initialize a new payment method.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
POST hotel-bookings/:hotel_booking_id/edit/price-changes

Adds new price change to a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
GET hotel-bookings/:hotel_booking_id/edit/price-changes

Get booking price changes section

Authorization:

PUT hotel-bookings/:hotel_booking_id/edit/price-changes/:price_change_id

Updates a price change from a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string The type of the reference
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
DELETE hotel-bookings/:hotel_booking_id/edit/price-changes/:price_change_id

Delete a price change from a booking

Authorization:

POST hotel-bookings/:hotel_booking_id/edit/price-changes/confirm

Confirm all price changes that are in draft status

Authorization:

POST hotel-bookings/:hotel_booking_id/edit/price-changes/discard

Discard all price changes that are in draft status

Authorization:

GET hotel-custom-rates

Get the full hotel custom rates list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
name
optional
string Filter hotel custom rates by name
hotel_id
optional
string Filter hotel custom rates by hotel_id
account_id
optional
string Filter hotel custom rates by account_id
is_active
optional
boolean Filter hotel custom rates by active flag.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
GET hotel-custom-rates/:id

Get the hotel custom rate details.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates

Create a hotel custom rate.

Authorization: superadmin

Attributes Type Authorization Description
name
required
string The hotel custom rate name.
account_id
required
string The hotel custom rate account id
hotel_id
required
string The hotel custom rate hotel id
hotel_email
required
string The hotel email
agreement_info
optional
string The agreement info.
is_active
required
boolean Indicate if the hotel custom rate is currently active.
expiration_date
required
string Indicate if the hotel custom rate is currently active.
rooms
optional
array The hotel custom rates rooms.
locale
optional
string Hotel custom rate locale
min_confirmation_days
required
number Maximum number of days in which it is possible to act on the rate (starting from the checkin date)
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/:id/upload-attachments

Upload a list of files associated to a hotel custom rate.

Authorization: member admin superadmin

Attributes Type Authorization Description
attachments
required
array The files list
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
POST hotel-custom-rates/:id/delete-attachments

Delete hotel custom rate attachments.

Authorization: member admin superadmin

Attributes Type Authorization Description
attachments_ids
required
array The attachments ids
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
PUT hotel-custom-rates/:id

Update a hotel custom rate.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string The hotel custom rate name.
hotel_id
optional
string The hotel custom rate hotel id
hotel_email
optional
string The hotel email
agreement_info
optional
string The agreement info.
is_active
optional
boolean Indicate if the hotel custom rate is currently active.
expiration_date
optional
string Indicate if the hotel custom rate is currently active.
locale
optional
string Hotel custom rate locale
min_confirmation_days
optional
number Maximum number of days in which it is possible to act on the rate (starting from the checkin date)
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/:id/add-room

Add a room to an hotel custom rate.

Authorization: superadmin

Attributes Type Authorization Description
name
required
string The hotel custom room name.
guests
required
object The hotel custom room guest informations.
type
required
string The hotel custom room type.
price
required
number The hotel custom room price.
currency
optional
string The hotel custom room currency.
max_quantity
optional
number The hotel custom room max quantity.
is_refundable
required
boolean Indicates if the room rate is refundable.
min_refundable_days
optional
number Refundabled date deadline (referred to the check in date).
is_active
required
boolean Indicate if the hotel custom rate room is currently active.
rules
optional
object Hotel custom rate rules
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT hotel-custom-rates/:custom_rate_id/room/:room_id

Update a hotel custom rate room.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string The hotel custom room name.
guests
optional
object The hotel custom room guest informations.
type
optional
string The hotel custom room type.
price
optional
number The hotel custom room price.
currency
optional
string The hotel custom room currency.
max_quantity
optional
number The hotel custom room max quantity.
is_refundable
optional
boolean Indicates if the room rate is refundable.
min_refundable_days
optional
number The hotel custom room max quantity.
is_active
optional
boolean Indicate if the hotel custom rate room is currently active.
rules
optional
object Hotel custom rate rules
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
DELETE hotel-custom-rates/:id

Delete a hotel custom rate.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
DELETE hotel-custom-rates/:custom_rate_id/room/:room_id

Delete a hotel custom rate room.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
GET hotel-custom-rates/booking/:token

Endpoint used by the hotel to get the custom rate booking.

Authorization: guest

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/booking/:token/confirm

Endpoint used by the hotel to confirm the custom rate booking

Authorization: guest

Attributes Type Authorization Description
employee_name
required
string Name of the hotel employee who confirms the booking
provider_code
optional
null|string Internal booking code of the hotel
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/booking/:token/void

Endpoint used by the hotel to void the custom rate booking

Authorization: guest

Attributes Type Authorization Description
employee_name
required
string Name of the hotel employee who refuses the booking
motivation
required
string Reason for which the booking was refused by the hotel
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/booking/:token/confirm-cancellation

Endpoint used by the hotel to confirm the custom rate cancellation request

Authorization: guest

Attributes Type Authorization Description
employee_name
required
string Name of the hotel employee who confirm the cancellation request
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
POST hotel-custom-rates/booking/:token/refuse-cancellation

Endpoint used by the hotel to refuse the custom rate cancellation request

Authorization: guest

Attributes Type Authorization Description
employee_name
required
string Name of the hotel employee who refuses the cancellation request
motivation
required
string Reason for which the booking was refused by the hotel
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
GET hotel-custom-rates/booking/:id/resend-notification

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
NOT_FOUND The resource you are trying to get not exists.
GET hotels/property-types

Get the hotel property.

Authorization: member admin app superadmin

GET hotels/rate-policies

Get the hotel rate cancellation policies.

Authorization: member admin app superadmin

GET hotels/rate-types

Get the hotel rate types.

Authorization: member admin app superadmin

GET hotels

Get the hotels list.

Authorization: member admin app superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
name
optional
string Filter hotels by name
stars
optional
string Filter hotels by stars
giataId
optional
string Filter hotels by giataId
property_type
optional
string Filter hotels by typology.
country
optional
string Filter hotels by country.
city
optional
string Filter hotels by city.
chain_id
optional
string Filter hotels by chain_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotels/:hotel_id

Get the hotel detail.

Authorization: member admin app superadmin

POST hotels

Manually add a new hotel.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string Name of the hotel.
stars
optional
number Stars of the hotel.
property_type
optional
string Typology of the hotel.
latitude
optional
string Latitude coordinates of the hotel.
longitude
optional
string Longitude coordinates of the hotel.
country
optional
string Country where the hotel resides.
is_active
optional
boolean Sets whether the hotel is active or not.
default_image
optional
string Default hotel picture.
images
optional
array Default hotel picture.
giataId
optional
string Giata ID of the hotel.
currency
optional
string Currency of the hotel.
total_rooms
optional
number Number of total rooms of the hotel.
phone
optional
string Phone number of the hotel.
web
optional
string Web site of the hotel.
email
optional
string Email address of the hotel.
address
optional
string Address of the hotel.
city
optional
string City of the hotel.
postal_code
optional
string Postal code of the hotel.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT hotels/:hotel_id

Manually update an existing hotel.

Authorization: superadmin

Attributes Type Authorization Description
name
optional
string Name of the hotel.
stars
optional
number Stars of the hotel.
property_type
optional
string Typology of the hotel.
latitude
optional
string Latitude coordinates of the hotel.
longitude
optional
string Longitude coordinates of the hotel.
country
optional
string Country where the hotel resides.
is_active
optional
boolean Sets whether the hotel is active or not.
default_image
optional
string Default hotel picture.
images
optional
array Default hotel picture.
giataId
optional
string Giata ID of the hotel.
currency
optional
string Currency of the hotel.
total_rooms
optional
number Number of total rooms of the hotel.
phone
optional
string Phone number of the hotel.
web
optional
string Web site URL of the hotel.
email
optional
string Email address of the hotel.
address
optional
string Address of the hotel.
city
optional
string City of the hotel.
postal_code
optional
string Postal code of the hotel.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE hotels/:hotel_id

Delete a hotel.

Authorization: superadmin

POST hotels/solutions/searches

Create an hotel search

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string superadmin The account_id context
place_id
required
string A place id.
check_in
required
string The check-in date in the format YYYY/MM/DD.
check_out
required
string The check-out date in the format YYYY/MM/DD.
locale
required
string The locale for the language of the results contents.
rooms
required
array An array containing the number of adults and child with their ages.
nationality
optional
string User nationality.
is_package_search
optional
boolean A flag to check if user is booking other verticals with us.
merchant
optional
string Specify a merchant
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotels/solutions/searches/:search_id

Get hotel search solutions update

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price, stars, review_score, priority and distance.
only_available_rates
optional
boolean Filter by available rates.
only_preferred_hotels
optional
boolean Filter by preferred hotels.
only_recommended_hotels
optional
boolean Filter by recommended hotels.
is_negotiated
optional
boolean Filter by is_negotiated.
name
optional
string Filter by hotel name.
distance
optional
number Filter by distance from the center.
stars
optional
string Filter by hotel stars.
review_score
optional
number Filter by hotel review score.
property_types
optional
string Filter by hotel property types.
price
optional
string Filter by price range.
attributes
optional
string Filter by attributes.
hotel_chains
optional
string Filter by hotel chains.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotels/fares/searches

Create a hotel search fares session

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string superadmin The account_id context
hotel_id
required
string A place id.
check_in
required
string The check-in date in the format YYYY/MM/DD.
check_out
required
string The check-out date in the format YYYY/MM/DD.
locale
required
string The locale for the language of the results contents.
rooms
required
array An array containing the number of adults and child with their ages.
nationality
optional
string User nationality.
is_package_search
optional
boolean A flag to check if user is booking other verticals with us.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotels/fares/searches/:search_id

Get hotel search fares update

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price.
price
optional
string Filter by price range.
cancellation_policy
optional
string Filter by cancellation policy.
type
optional
string Filter by rate type.
merchant
optional
string Filter by merchant.
room_codes
optional
string Filter by room codes.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST hotels/fares

Create a fare

Authorization:

Attributes Type Authorization Description
search_fare_id
required
string A search fare id.
locale
required
string The locale for the language of the results contents.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET hotels/fares/:fare_id

Get a fare

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET property-types

Get the hotel property.

Authorization: member admin app superadmin

GET rate-policies

Get the hotel rate cancellation policies.

Authorization: member admin app superadmin

GET rate-types

Get the hotel rate types.

Authorization: member admin app superadmin

GET invoice-profiles

Get invoice profiles list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter by invoice profile id
account_id
optional
string Filter by account id
name
optional
string Filter by name
is_deleted
optional
boolean Filter by is deleted
user_id
optional
string Filter by user id
name_or_id
optional
string Filter by name or id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-profiles/my-account

Get all invoice profiles of my account.

Authorization: admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter by invoice profile id
account_id
optional
string Filter by account id
name
optional
string Filter by name
is_deleted
optional
boolean Filter by is deleted
user_id
optional
string Filter by user_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-profiles/my-user

Get all invoice profiles of my user.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter by invoice profile id
account_id
optional
string Filter by account id
name
optional
string Filter by name
is_deleted
optional
boolean Filter by is deleted
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-profiles/public

Get all public invoice profiles of my account.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter by invoice profile id
account_id
optional
string Filter by account id
name
optional
string Filter by name
is_deleted
optional
boolean Filter by is deleted
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-profiles/:invoice_profile_id

Get invoice profile details.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoice-profiles

Create new invoice profile.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
Required only for superadmins
string superadmin The invoice profile account id
name
required
string The invoice profile name
default_billing_address_id
optional
string The invoice profile name
is_personal
required
boolean Define if the invoice profile is personal
is_deleted
optional
boolean Define if the invoice profile is deleted
email_destinataries
optional
array Admin emails where to send the invoices.
allowed_users
optional
array Users allowed to use this profile
allowed_groups
optional
array Groups of users allowed to use this profile
default_payment_method
optional
string The default_payment_method
default_payment_option
optional
string The default_payment_option than can be id or code number
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT invoice-profiles/:invoice_profile_id

Update an invoice profile.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string The invoice profile account id
user_id
optional
string The invoice profile user id
name
optional
string The invoice profile name
default_billing_address_id
optional
string The invoice profile name
is_personal
optional
boolean Define if the invoice profile is personal
is_deleted
optional
boolean Define if the invoice profile is deleted
email_destinataries
optional
array Admin emails where to send the invoices.
allowed_users
optional
array Users allowed to use this profile
allowed_groups
optional
array Groups of users allowed to use this profile
default_payment_method
optional
string The default_payment_method
default_payment_option
optional
string The default_payment_option than can be id or code number
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE invoice-profiles/:invoice_profile_id

Set 'is_deleted' true on a giving invoice profile.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-reports

Get all invoice reports.

Authorization: admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter invoice reports by id
account_id
optional
string superadmin Filter invoice reports by account_id
is_internal
optional
boolean superadmin Filter invoice reports by is_internal
name
optional
string Filter invoice reports by name
number
optional
string Filter invoice reports by number
created_from
optional
string Filter invoice reports by creation from
created_to
optional
string Filter invoice reports by creation to
is_automatic
optional
boolean Filter automatic invoice reports
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-reports/:invoice_report_id

Get the invoice report detail.

Authorization: admin superadmin

GET invoice-reports/:invoice_report_id/invoices

Get all invoices that matches the report specification.

Authorization: admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoice-reports/:invoice_report_id/stats

Get stats of an invoice report.

Authorization: admin superadmin

POST invoice-reports

Create an invoice report.

Authorization: admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
is_internal
optional
boolean superadmin Define if the report is for internal use
name
required
string Name of the invoice report.
filters.issue_date_from
required
string Issue date from of the invoice report.
filters.issue_date_to
required
string Issue date to of the invoice report.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoice-reports/:invoice_report_id/download

Download invoices of a specific invoice report

Authorization: member admin app superadmin

PUT invoice-reports/:invoice_report_id

Update an invoice report.

Authorization: admin superadmin

Attributes Type Authorization Description
is_internal
optional
boolean superadmin Define if the report is for internal use
name
optional
string Name of the invoice report.
filters.issue_date_from
optional
string Issue date from of the invoice report.
filters.issue_date_to
optional
string Issue date to of the invoice report.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE invoice-reports/:invoice_report_id

Delete an invoice report.

Authorization: admin superadmin

GET invoices

Get all invoices.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
id
optional
string Filter invoices by id
account_id
optional
string Filter invoices by account_id
billing_address_id
optional
string admin,superadmin Filter invoices by billing_address_id
invoice_profile_id
optional
string admin,superadmin Filter invoices by invoice profile id
sectional
optional
string Filter invoices by sectional
number
optional
string Filter invoices by number
category
optional
string Filter invoices by category
created_from
optional
string Filter invoices by creation from
created_to
optional
string Filter invoices by creation to
issue_date_from
optional
string Filter invoices by issued from
issue_date_to
optional
string Filter invoices by issued to
payment_deadline_from
optional
string Filter invoices by payment deadline from
payment_deadline_to
optional
string Filter invoices by payment deadline to
status
optional
string Filter invoices by status
is_registered
optional
boolean Filter registered invoices
registration_status
optional
string Filter invoices by registration status
is_rounding
optional
boolean Filter service if has rounding
is_agency_regime
optional
boolean Filter agency regime invoices
credit_note_number
optional
string Filter invoices by credit note number
credit_note_created_from
optional
string Filter invoices by credit note creation from
credit_note_created_to
optional
string Filter invoices by credit note creation to
credit_note_issue_date_from
optional
string Filter invoices by credit note issued from
credit_note_issue_date_to
optional
string Filter invoices by credit note issued to
credit_note_is_registered
optional
boolean Filter registered credit note invoices
account_lead_source
optional
string Filter invoices by account lead source
destinatary_country
optional
string Filter invoices by destinatary country
is_personal
optional
boolean Filter personal invoices
version
optional
number Filter by version
preferred_booking_payment_method
optional
string Filter invoices by payment method
commercial_responsible
optional
string Filter invoices by commercial_responsible_id
vat_code
optional
string Filter invoices by vat_code
sectional
optional
string Filter invoices by sectional, can be vat_recovery or standard_it
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoices/stats

Get invoices stats.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
account_id
optional
string Filter invoices by account_id
category
optional
string Filter invoices by category
sectional
optional
string Filter invoices by sectional
created_from
optional
string Filter invoices by creation from
created_to
optional
string Filter invoices by creation to
issue_date_from
optional
string Filter invoices by issued from
issue_date_to
optional
string Filter invoices by issued to
payment_deadline_from
optional
string Filter invoices by payment deadline from
payment_deadline_to
optional
string Filter invoices by payment deadline to
preferred_booking_payment_method
optional
string Filter invoices by payment method
commercial_responsible
optional
string Filter invoices by commercial_responsible_id
status
optional
string Filter invoices by status
is_registered
optional
boolean Filter registered invoices
is_agency_regime
optional
boolean Filter agency regime invoices
billing_address_id
optional
string Filter by billing address
is_personal
optional
boolean Filter personal invoices
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET invoices/settings

Get all invoices settings.

Authorization:

GET invoices/:invoice_id

Get the invoice detail.

Authorization:

PUT invoices/:invoice_id

Update an account invoice.

Authorization:

Attributes Type Authorization Description
number
optional
string The invoice number
issue_date
optional
string The invoice issue date
account_id
optional
string The invoice account id
category
optional
string The invoice category
locale
optional
string The invoice locale
billing_address_id
optional
string The invoice assocaited billing address
invoice_profile_id
optional
string The invoice profile id
fiscal_products
optional
array The fiscal products of the invoice
services
optional
array The invoice list of services
is_registered
optional
boolean Define if the invoice is registered
is_agency_regime
optional
boolean Define if the invoice is agency regime
status
optional
string The invoice status
inner_transactions
optional
array Update invoice inner transactions
destinatary.sdi_code
required
null|string The sdi code of electronic invoicing
destinatary.pec
required
null|string Pec
version
optional
number The invoice version
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/:invoice_id/update-document

Update the pdf document

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/download-excel

Download invoice excel.

Authorization:

Attributes Type Authorization Description
invoice_id
required
string invoice id to download excel
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/download-pdf

Download invoice pdf.

Authorization:

Attributes Type Authorization Description
invoice_id
required
string invoice id to download pdf
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/product-details-fields

Get the invoice product details configuration.

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/download-product-details

Download invoice product details csv.

Authorization:

Attributes Type Authorization Description
invoice_id
required
string invoice id
csv_fields_config
required
string List of fields to include in the prodict details csv.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/download

Download a zip of invoices

Authorization:

Attributes Type Authorization Description
ids
optional
array Array of invoices id to download in a zip
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/export

Export invoices

Authorization:

Attributes Type Authorization Description
created_from
optional
string Filter fiscal documents by creation from
created_to
optional
string Filter fiscal documents by creation to
issue_date_from
optional
string Filter fiscal documents by issued from
issue_date_to
optional
string Filter fiscal documents by issued to
payment_deadline_from
optional
string Filter fiscal documents payment deadline from
payment_deadline_to
optional
string Filter fiscal documents by payment deadline to
account_id
optional
string Filter fiscal documents by account_id
is_registered
optional
boolean Filter registered fiscal documents
is_agency_regime
optional
boolean Filter agency regime fiscal documents
format
optional
string Allows to choose the format in which exports will be generated
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/inner-transactions/export

Export inner transactions

Authorization:

Attributes Type Authorization Description
transfer_date_from
optional
string Filter inner transactions by transfer date from
transfer_date_to
optional
string Filter inner transactions by transfer date to
format
optional
string Allows to choose the format in which exports will be generated
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/bulk-update

Bulk update of invoices

Authorization:

Attributes Type Authorization Description
values.is_registered
optional
boolean Define if the invoice is registered
filters.number
optional
string Filter invoices by number
filters.category
optional
string Filter invoices by category
filters.created_from
optional
string Filter invoices by creation from
filters.created_to
optional
string Filter invoices by creation to
filters.issue_date_from
optional
string Filter invoices by issued from
filters.issue_date_to
optional
string Filter invoices by issued to
filters.status
optional
string Filter invoices by status
filters.is_registered
optional
boolean Filter registered invoices
filters.is_agency_regime
optional
boolean Filter agency regime invoices
filters.credit_note_number
optional
string Filter invoices by credit note number
filters.credit_note_created_from
optional
string Filter invoices by credit note creation from
filters.credit_note_created_to
optional
string Filter invoices by credit note creation to
filters.credit_note_issue_date_from
optional
string Filter invoices by credit note issued from
filters.credit_note_issue_date_to
optional
string Filter invoices by credit note issued to
filters.credit_note_is_registered
optional
boolean Filter registered credit note invoices
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST invoices/inner-transactions/bulk-update

Bulk update of inner transactions

Authorization:

Attributes Type Authorization Description
values.is_registered
optional
boolean Define if the invoice is registered
filters.transfer_date_from
optional
string Filter inner transaction by transfer date from
filters.transfer_date_to
optional
string Filter inner transaction by transfer date to
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE invoices/:invoice_id

Delete an account invoice.

Authorization:

GET licence-reports

Get all the licence reports.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
id
optional
string Filter licence reports by id
account_id
optional
string superadmin Filter licence reports by account_id
issue_date_from
optional
string Filter licence reports by issue date from
issue_date_to
optional
string Filter invoice reports by issue date to
is_delivered
optional
boolean Filter licence report delievered
status
optional
string Filter licence report by status
license_type
optional
string Filter licence by license type
GET licence-reports/:licence_report_id

Get the licence report detail.

Authorization: admin superadmin

DELETE licence-reports/:licence_report_id

Delete a licence report.

Authorization:

POST licence-reports

Create a licence report.

Authorization:

Attributes Type Authorization Description
account_id
required
string The licence report account id
is_internal
optional
boolean Licence report is internal or not
issue_date_from
optional
string The licence report start date
issue_date_to
optional
string The licence report end date
name
optional
string The licence report name
PUT licence-reports/:licence_report_id

Update a licence report.

Authorization:

Attributes Type Authorization Description
email_destinataries
optional
array The report email destinataries
total_amendment
optional
float The total amendment granted for the report
status
optional
string The status of the report
GET licence-reports/:licence_report_id/send

Send an already created license report.

Authorization:

GET licence-reports/:licence_report_id/create_report_file

Recreates xls report file.

Authorization:

Attributes Type Authorization Description
locale
required
string The locale.
POST licence-reports/:licence_report_id/items

Update a licence report with new items

Authorization:

Attributes Type Authorization Description
items
optional
array Add new bookings to the report
PUT licence-reports/:licence_report_id/items/:item_id

Update a licence report item

Authorization:

Attributes Type Authorization Description
amount
optional
float The item amount
market_price_savings
optional
float The item market price savings
POST licence-reports/:licence_report_id/delete-items

Delete a list of licence report items.

Authorization:

Attributes Type Authorization Description
item_ids
optional
array The item ids to remove from the report
DELETE licence-reports/:licence_report_id/items/:item_id

Delete an item from the licence report.

Authorization:

POST payment-methods/init-braintree

Init Braintree.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST payment-methods/init-paypal

Initialize a PayPal transaction.

Authorization: member admin superadmin

Attributes Type Authorization Description
ref_type
required
string A referement type.
ref_id
required
string A booking id.
return_url
required
string The paypal return url.
cancel_url
required
string The paypal cancel url.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET railcards

Get all railcards.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
users_ids
optional
string Filter railcard by creator id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET railcards/:railcard_id

Get railcard details.

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST railcards

Create new railcard.

Authorization:

Attributes Type Authorization Description
name
required
string The railcard name
number
optional
string The railcard number
account_id
Required only for superadmins
string The railcard owner account id
user_id
optional
string The railcard user id
railcard_type_id
required
string The railcard type id
first_name
required
string First name of the owner
last_name
required
string Last name of the owner
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT railcards/:railcard_id

Update a railcard.

Authorization:

Attributes Type Authorization Description
name
optional
string The railcard name
user_id
Only a superadmin can change the railcard user reference
string The railcard owner id
account_id
Only a superadmin can change the railcard account reference
string The railcard owner account id
first_name
required
string First name of the owner
last_name
required
string Last name of the owner
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE railcards/:railcard_id

Delete a railcard.

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET room-types

Get the full hotel room types list.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
id
optional
string Filter room types by id
code
optional
string Filter room types by code
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET room-types/:room_type_id

Get the hotel room type details.

Authorization: member admin superadmin

POST room-types

Create a new hotel room type

Authorization: superadmin

Attributes Type Authorization Description
code
optional
string Internal code to map a specific hotel room type
translation_id
optional
string Translation id ref
matches
optional
array Keywords that must match a room name in order to map it
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
PUT room-types/:room_type_id

Manually update an hotel room type.

Authorization: superadmin

Attributes Type Authorization Description
code
optional
string Internal code to identify and map a specific hotel room type
translation_id
optional
string Translation id associated to the room type
matches
optional
array Keywords that must match a room name in order to map it
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
DELETE room-types/:room_type_id

Delete an hotel room type.

Authorization: superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET search

Search for places or hotels

Authorization: member admin app superadmin

Attributes Type Authorization Description
q
required
string The term to search inside our search engine
locale
required
string The locale for search the term
types
optional
string A comma separated list of types of results you want, if not specified any results will be showed
places_type
optional
string The place type of results you want, if not specified any results will be showed
exclude_meta
optional
boolean Exclude meta data from output
GET search/stations

Search for stations

Authorization: member admin app superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
locale
required
string The locale for search the term
place_id
required
string The palce id to search inside our search engine
GET search/airports

Search for airports

Authorization: member admin app superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
place_id
required
string The palce id to search inside our search engine
locale
required
string The locale
GET search/car-places

Search for airports

Authorization: member admin app superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
place_id
required
string The palce id to search inside our search engine
locale
required
string The locale
GET search-presets/my-account

Get all search presets of my account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
account_id
optional
string Filter by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
GET search-presets/my-user

Get all search presets of my user.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
GET search-presets/public

Get all search presets public of my account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
account_id
optional
string Filter by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
GET search-presets/:search_preset_id

Get the search preset detail.

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST search-presets

Create a search preset.

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
objectId The account_id context
name
required
string The search preset name
is_public
optional
boolean Indicates if the search preset is public
type
required
string The search preset type
filters
optional
array Filters array with filters data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
PUT search-presets/:search_preset_id

Update a search preset.

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
objectId The account_id context
name
optional
string The search preset name
is_public
optional
boolean Indicates if the search preset is public
type
required
string The search preset type
filters
optional
array Filters array with filters data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
DELETE search-presets/:search_preset_id

Deletes a search preset.

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST tests/params

TEST PARAMS

Authorization: superadmin

Attributes Type Authorization Description
param1
required
integer Param 1
obj.param2
required
integer Param 2
obj.param3
required
integer Param 3
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST tests/emails

Send an email

Authorization: superadmin

Attributes Type Authorization Description
booking_id
required
string The entity booking id
entity_type
required
string The entity type
action
required
string The kind of email to excecute
email
required
string The destinatary email
locale
required
string The locale for the email
data
required
object The extra data required for every kind of email action
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/email-template

Test email cration in browser

Authorization: superadmin

Attributes Type Authorization Description
entity_id
optional
string The entity booking id
entity_type
optional
string The entity type
prebuilt
required
string The kind of email to excecute
locale
required
string The locale for the email
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/hotel-booking-voucher-creation

Test pdf creation for vauchers from the browser.

Authorization: guest superadmin

Attributes Type Authorization Description
id
required
string The booking id
locale
required
string The locale for the email
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/car-booking-voucher-creation

Test pdf creation for vauchers from the browser.

Authorization: guest admin superadmin

Attributes Type Authorization Description
id
required
string The booking id
locale
required
string The locale for the email
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST tests/flight-booking-boarding-pass-email

Send flight booking boarding passes email

Authorization: superadmin

Attributes Type Authorization Description
id
required
string The flight booking id
departure_airport
required
string The iata code of the departure airport
arrival_airport
required
string The iata code of the arrival airport
boarding_pass_file
required
string The boarding pass file url
email
required
string The destinatary email
locale
required
string The locale for the email
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/flight-booking-ticket-creation

Test pdf creation for tickets from the browser.

Authorization: guest superadmin

Attributes Type Authorization Description
id
required
string The booking id
locale
required
string The locale for the email
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/invoice-creation

Test invoice pdf creation from the browser.

Authorization: guest superadmin

Attributes Type Authorization Description
id
required
string The invoice id
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/invoice-details-creation

Test invoice details pdf creation from the browser.

Authorization: guest superadmin

Attributes Type Authorization Description
id
required
string The invoice id
locale
required
string The locale for the email
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/credit-note-creation

Test credit note pdf creation from the browser.

Authorization: guest superadmin

Attributes Type Authorization Description
id
required
string The invoice id
mode
optional
string The output type. Default stream.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST tests/invitation-email

Send invite email

Authorization: superadmin

Attributes Type Authorization Description
user_id
required
string The destinatary user_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
NOT_ACTIVE The resource you are trying to use is not active.
EMAIL_ALREADY_USED The email you are trying to use is already in use.
POST tests/logs

Test some logs

Authorization: superadmin

Attributes Type Authorization Description
type
required
string The log type
message
required
string The log message
POST tests/mystifly

Test mystifly client

Authorization: superadmin

POST tests/misterroom

Test MisterRoom client

Authorization: superadmin

POST tests/bookingcom

Test Booking.com client

Authorization: superadmin

POST tests/eps/client

Test EPS client

Authorization: superadmin

POST tests/amadeus

Test Amadeus

Authorization: superadmin

POST tests/amadeus/hotel-descriptive-info

Test Amadeus hotel descriptive info

Authorization: superadmin

Attributes Type Authorization Description
hotel_code
required
string The hotel code
POST tests/amadeus/hotel-availability

Test Amadeus hotel availability info

Authorization: superadmin

Attributes Type Authorization Description
hotel_code
required
string The hotel code
POST tests/amadeus/hotel-corporate-availability

Test Amadeus corporate rates availability

Authorization: superadmin

POST tests/notifications

Test notifications

Authorization: superadmin

POST tests/new_notifications

Test notifications

Authorization:

POST tests/monthly-invoice-report

Send monthly invoice report email

Authorization: superadmin

Attributes Type Authorization Description
id
required
string The invoice report id
email
required
string The destinatary email
locale
required
string The locale for the email
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/providerSettings

test provider settings

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET tests/entitiesSettings

test entities settings

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST tests/batch-remove-invoices

Send monthly invoice report email

Authorization: superadmin

Attributes Type Authorization Description
number_from
required
number The invoice number from
number_to
required
number The invoice number to
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET train-bookings/drafts

Get Car Bookings in draft status

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
id
optional
string Filter car bookings by id
code
optional
string Filter car bookings by code
GET train-bookings

Get the full train bookings list.

Authorization: superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter train bookings by plan id.
has_extra_services
optional
boolean Filter train bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter train bookings by id
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
billing_address_id
optional
string Filter train bookings by billing address id
invoice_profile_id
optional
string Filter train bookings by invoice profile id
code
optional
string Filter train bookings by code
status
optional
string Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
cancelled_from
optional
string Filter train bookings by cancellation from
cancelled_to
optional
string Filter train bookings by cancellation to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
train_carriers
optional
string Filter train bookings that contains at least one train carrier. Format should be all ids separated by ,
departure_date_from
optional
string Filter train bookings by departure from
departure_date_to
optional
string Filter train bookings by departure to
traveller_ids
optional
string Filter train bookings by passengers
needs_approval
optional
boolean Filter train bookings by needs approval
is_policy_respected
optional
boolean Filter train bookings by policy respected
total_amount
optional
float Filter train bookings by total amount
invoice_ids
optional
string Filter train bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter train bookings by is personal
license_fee
optional
integer Filter train bookings by license fee
client_classification
optional
string Filter train bookings by client classification.
client_type
optional
string Filter train bookings by client type.
merchant
optional
string Filter train bookings by merchant
vendor
optional
string Filter train bookings by vendor name
supplier_code
optional
string Filter train bookings by supplier_code
approver_id
optional
string Filter train bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter train bookings by is_vat_recovery_eligible.
account_id
optional
string Filter train bookings by account_id
account_ids
optional
array Filter train bookings by account_ids
exclude_account_ids
optional
array Filter train bookings by exclude account_ids
provider_code
optional
string Filter train bookings by provider_code
provider_key
optional
string Filter train bookings by provider key
bizzyflex_statuses
optional
string Filter flight bookings by bizzyflex status
payment_method
optional
string Filter train bookings by payment method
custom_fields
optional
string Custom fields
is_manual
optional
boolean Filter train bookings by is manual
automatic_invoice
optional
boolean Filter train bookings if auto invoice is active or not
version
optional
number Filter train bookings by version (1, 1.5 or 2)
payment_status
optional
string Filter train bookings by payment status (not_paid, partly_paid or paid)
is_regional
optional
boolean Filter for regional train (italy)
GET train-bookings/my-user

Get the full train bookings list of the session user.

Authorization: member admin superadmin

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter train bookings by plan id.
has_extra_services
optional
boolean Filter train bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter train bookings by id
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
billing_address_id
optional
string Filter train bookings by billing address id
invoice_profile_id
optional
string Filter train bookings by invoice profile id
code
optional
string Filter train bookings by code
status
optional
string Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
cancelled_from
optional
string Filter train bookings by cancellation from
cancelled_to
optional
string Filter train bookings by cancellation to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
train_carriers
optional
string Filter train bookings that contains at least one train carrier. Format should be all ids separated by ,
departure_date_from
optional
string Filter train bookings by departure from
departure_date_to
optional
string Filter train bookings by departure to
traveller_ids
optional
string Filter train bookings by passengers
needs_approval
optional
boolean Filter train bookings by needs approval
is_policy_respected
optional
boolean Filter train bookings by policy respected
total_amount
optional
float Filter train bookings by total amount
invoice_ids
optional
string Filter train bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter train bookings by is personal
license_fee
optional
integer Filter train bookings by license fee
client_classification
optional
string Filter train bookings by client classification.
client_type
optional
string Filter train bookings by client type.
merchant
optional
string Filter train bookings by merchant
vendor
optional
string Filter train bookings by vendor name
supplier_code
optional
string Filter train bookings by supplier_code
approver_id
optional
string Filter train bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter train bookings by is_vat_recovery_eligible.
GET train-bookings/my-account

Get the full train bookings list of an account.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
sort
optional
string The sort modality
locale
required
string The locale for the language of the results contents.
plan_id
optional
string Filter train bookings by plan id.
has_extra_services
optional
boolean Filter train bookings by extra services.
extra_services
optional
array Filter hotel bookings by extra service type.
id
optional
string Filter train bookings by id
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
billing_address_id
optional
string Filter train bookings by billing address id
invoice_profile_id
optional
string Filter train bookings by invoice profile id
code
optional
string Filter train bookings by code
status
optional
string Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
cancelled_from
optional
string Filter train bookings by cancellation from
cancelled_to
optional
string Filter train bookings by cancellation to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
train_carriers
optional
string Filter train bookings that contains at least one train carrier. Format should be all ids separated by ,
departure_date_from
optional
string Filter train bookings by departure from
departure_date_to
optional
string Filter train bookings by departure to
traveller_ids
optional
string Filter train bookings by passengers
needs_approval
optional
boolean Filter train bookings by needs approval
is_policy_respected
optional
boolean Filter train bookings by policy respected
total_amount
optional
float Filter train bookings by total amount
invoice_ids
optional
string Filter train bookings by invoice_id
invoicing_status
optional
string Return flight bookings based on its invoicing status
is_personal
optional
boolean Filter train bookings by is personal
license_fee
optional
integer Filter train bookings by license fee
client_classification
optional
string Filter train bookings by client classification.
client_type
optional
string Filter train bookings by client type.
merchant
optional
string Filter train bookings by merchant
vendor
optional
string Filter train bookings by vendor name
supplier_code
optional
string Filter train bookings by supplier_code
approver_id
optional
string Filter train bookings by approver_id.
is_vat_recovery_eligible
optional
boolean Filter train bookings by is_vat_recovery_eligible.
account_id
optional
string superadmin Filter train bookings by account_id
GET train-bookings/:train_booking_id

Get the train booking detail.

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
POST train-bookings/calculate-costs

Calculate costs of a train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
train_booking_id
required if rate_id not filled
string The train booking id.
outbound_fares_ids
required if trainBooking_id not filled
array An array with all outbound fares of the train selected by the customer.
inbound_fares_ids
optional
array An array with all inbound fares of the train selected by the customer.
locale
required
string The locale.
payment_method
optional
string The payment method.
billing_address_id
optional
string The billing address id
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
is_personal
required
boolean Indicates if the booking is personal.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/generate-csv

Generate a csv file with the full train bookings list

Authorization: superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
code
optional
string Filter train bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
departure_date_from
optional
string Filter train bookings by departure date from
departure_date_to
optional
string Filter train bookings by departure date to
traveller_ids
optional
array Filter train bookings by guets
needs_approval
optional
boolean Filter train bookings by needs approval
invoice_ids
optional
array Filter train bookings by invoice_id
invoicing_status
optional
array Return train bookings based on its invoicing status
invoice_profile_id
optional
string Filter train bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter train bookings by extra service type.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/my-account/generate-csv

Generate a csv file with the full train bookings list of an account

Authorization: admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
code
optional
string Filter train bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
departure_date_from
optional
string Filter train bookings by departure date from
departure_date_to
optional
string Filter train bookings by departure date to
traveller_ids
optional
array Filter train bookings by guets
needs_approval
optional
boolean Filter train bookings by needs approval
invoice_ids
optional
array Filter train bookings by invoice_id
invoicing_status
optional
array Return train bookings based on its invoicing status
invoice_profile_id
optional
string Filter train bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter train bookings by extra service type.
account_id
optional
string superadmin Filter train bookings by account_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/my-user/generate-csv

Generate a csv file with the full train bookings list of an user

Authorization: member admin superadmin

Attributes Type Authorization Description
creator_id
optional
string Filter train bookings by creator id
supervisor_id
optional
string Filter train bookings by supervisor id
code
optional
string Filter train bookings by code
locale
optional
string The locale for the language of the results contents.
status
optional
array Filter train bookings by status
created_from
optional
string Filter train bookings by creation from
created_to
optional
string Filter train bookings by creation to
updated_from
optional
string Filter train bookings by update from
updated_to
optional
string Filter train bookings by update to
departure_station_id
optional
string Filter train bookings by departure station
arrival_station_id
optional
string Filter train bookings by arrival station
departure_date_from
optional
string Filter train bookings by departure date from
departure_date_to
optional
string Filter train bookings by departure date to
traveller_ids
optional
array Filter train bookings by guets
needs_approval
optional
boolean Filter train bookings by needs approval
invoice_ids
optional
array Filter train bookings by invoice_id
invoicing_status
optional
array Return train bookings based on its invoicing status
invoice_profile_id
optional
string Filter train bookings by invoice profile id
custom_fields
optional
string Custom fields
extra_services
optional
array Filter train bookings by extra service type.
is_personal
optional
boolean Filter hotel bookings by is_personal
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/check

Check a trip

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
outbound_fares
required
array An array of fares id for the outbound
inbound_fares
optional
array An array of fares id for the inbound
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/prepare-booking

Check a trip

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
fares
required
array An array of fares id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings

Create a booking

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
user_id
optional
string superadmin The user_id (owner) of the context
fares_data_id
optional
string Fare id
holder_id
optional
string The id of the passenger selected by the customer as the booking holder.
passengers
required
array Array with all passengers ID.
phone
optional
string The phone number of the booking.
notes
optional
string The notes of the booking.
billing_address_id
optional
string The billing address id.
billing_address_project
required
string The project of the billing address.
invoice_profile_id
optional
string The invoice profile id.
payment.method
required
string The payment method.
payment.credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
payment.credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
is_personal
required
boolean Indicates if the booking is personal.
custom_fields
optional
object Object of custom fields
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
PUT train-bookings/:train_booking_id

Update a train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
status
optional
string superadmin The train booking status.
outbound_fares
optional
array Object array with fare IDs and relative data to update them.
inbound_fares
optional
array Object array with fare IDs and relative data to update them.
holder_id
optional
string The holder id.
passengers
optional
array Array with all passengers ID.
phone
optional
string The emergency phone of the booking.
notes
optional
string The notes of the passenger.
billing_address_id
optional
string The billing address id.
invoice_profile_id
optional
string The invoice profile id.
is_vat_exempt
optional
boolean superadmin Update booking vat exempt flag
automatic_invoice
optional
boolean superadmin Define if the booking will be automatically invoices
inner_transactions
optional
array superadmin Update booking inner transactions
transaction_costs
optional
number superadmin Update the transaction costs.
invoice_id
optional
null|string superadmin Update the booking invoice.
provider_code
optional
string superadmin Update the booking provider code.
seat
optional
object superadmin Update the seat number.
coach
optional
object superadmin Update the coach number.
train_code
optional
object superadmin Update the train code.
train_name
optional
object superadmin Update the train name.
datetime
optional
object superadmin Update the train departure / arrival datetime.
is_personal
optional
boolean superadmin Update the booking is_personal.
is_archived
optional
boolean superadmin Update the booking is_archived.
custom_fields
optional
object Object of custom fields
fare
optional
object superadmin Fare object
fare_provider_price
optional
number superadmin The provider price
fare_price
optional
number superadmin The fare price
issuing_fee
optional
number superadmin Update the fare issuing fee
source
optional
string superadmin The booking source.
license_fee
optional
number superadmin Update the licence fee.
version
optional
number superadmin Update the version of the booking.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
POST train-bookings/:train_booking_id/files

Upload a file

Authorization: superadmin

Attributes Type Authorization Description
file
required
file The file to upload
fare_id
required
string The related fare id
fare_type
required
string The fare type, outbound or inbound.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
DELETE train-bookings/:train_booking_id/files

Delete a file

Authorization: superadmin

Attributes Type Authorization Description
fare_id
required
string The related fare id
fare_type
required
string The fare type, outbound or inbound.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
POST train-bookings/:train_booking_id/approve

Approve the current booking

Authorization:

Attributes Type Authorization Description
price_tolerance
optional
number
Errors codes
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/reject

Reject booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Custom message to the booking creator.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/void

Void train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
message
optional
string Message to the booking creator if `notify` is true.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/trash

Trash booking.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/initialize

Initialize a train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
outbound_fares
required
array An array of fares id for the outbound
inbound_fares
optional
array An array of fares id for the inbound
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/process

Confirm train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
transaction_id
required
string The transaction_id to use in order to process this booking, not required for payment method === `postpay`
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
BOOKING_NOT_VALID_STATUS This booking is not in a valid status to execute the requested operation.
POST train-bookings/:train_booking_id/complete-process

Complete an train booking process.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST train-bookings/:train_booking_id/assign

Assign train booking to an admin

Authorization: superadmin

Errors codes
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
POST train-bookings/:train_booking_id/transactions

Create a transaction.

Authorization: member admin superadmin

Attributes Type Authorization Description
payment_method
required
string The payment method.
amount
optional
float superadmin The amount of the transaction. If is not filled the transaction amount will be calculated automatically from the booking.
payment_data.token
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
payment_data.payment_id
required when payment_method = paypal
string [PayPal] the paypal payment_id.
payment_data.payer_id
required when payment_method = paypal
string [PayPal] the paypal payer id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
PUT train-bookings/:train_booking_id/transactions/:transaction_id

Update a transaction.

Authorization: member admin superadmin

Attributes Type Authorization Description
payer_id
optional
string [PayPal] payer_id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST train-bookings/:train_booking_id/transactions/:transaction_id/void

Void a transaction.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST train-bookings/:train_booking_id/transactions/:transaction_id/capture

Capture a transaction.

Authorization: member admin superadmin

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST train-bookings/:train_booking_id/initialize-payment

Initialize a payment

Authorization: member admin superadmin

Attributes Type Authorization Description
payment_method
required
string The payment method.
credit_card_id
required when payment_method = cc
string [Credit Card] the token of the selected credit card.
credit_card_owner
required when payment_method = cc
string [Credit Card] the owner of the selected credit card.
paypal_payment_id
required when payment_method = paypal
string [PayPal] the paypal payment_id.
paypal_payer_id
required when payment_method = paypal
string [PayPal] the paypal payer id.
change_payment_method
optional
boolean Flag that indicates if the action is used to initialize a new payment method.
bta_account
required when payment_method = amex_bta
string [Amex BTA] amex bta account code.
hokodo_data
required when payment_method = hokodo
object [Hokodo] Object of Hokodo Data
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
INSUFFICIENT_FOUNDS_CC There not enoguh money to exeute the operation you request on the credit card of the user.
LIMIT_EXCEEDED_CC Unable to execute this operation, you have exceeded the maximum amount for your credit card.
CONTACT_TO_THE_BANK Unable to execute this operation, please contact your bank for more info!
EXPIRED_CARD_CC Your credit card looks like its already expired
STOLEN_CC The credit card has been flagged as stolen.
LOST_CC The credit card has been flagged as lost.
FRAUD_CC The credit card has been flagged as fraud.
TEMPORARY_ISSUE_CC Unable to execute this operation due to a temporary issu with the bank, try again!
POST train-bookings/:id/upload-attachments

Upload a list of files associated to a train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
attachments
optional
array The files list
is_internal
optional
null|boolean Specify if attachments are internal.
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
POST train-bookings/:id/delete-attachment

Delete an attachment file and remove it from a train booking.

Authorization: member admin superadmin

Attributes Type Authorization Description
attachment_id
optional
string The attachment id
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
GET old/train-bookings/:id/operations

Returns a list of possible postbooking options on a booking

Authorization: member admin superadmin

POST train-bookings/:id/cancel

Executes a cancellation/refund operation

Authorization:

Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST train-bookings/:id/solution/search

Search new solutions for a booking

Authorization: member admin superadmin

Attributes Type Authorization Description
type_change
optional
string Type of the change
account_id
optional
string Id of the account
country
optional
string Country of the search
itinerary
optional
array The itinerary of the search
locale
optional
string Locale of the search
passengers
optional
object Number of passengers
leg_ids
optional
array The list of leg ids
GET train-bookings/:id/solution/search/:solution_id

Get a search solution with an id

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string Id of the account
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price
price
optional
string Filter by price range.
trip_departure_times
optional
string Filter by trips departure times. It accepts comma separated values in minutes
POST train-bookings/:id/solution/search/:solution_id/fare

Starts a search of fares for a solution

Authorization: member admin superadmin

Attributes Type Authorization Description
type_change
optional
string Type of the change
account_id
optional
string superadmin Id of the account
locale
optional
string Locale of the search
GET train-bookings/:id/solution/search/:solution_id/:fare_id

Get a search of a fare with a given id

Authorization: member admin superadmin

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price.
price
optional
string Filter by price range.
POST train-bookings/:id/solution/search/:solution_id/:fare_id/confirm

Confirms the selection of a solution and a fare

Authorization: member admin superadmin

Attributes Type Authorization Description
change_operation
optional
string Transaction associated with the booking
expected_penalty
optional
number The expected penalty of the operation
POST train-bookings/:id/travellers_update

Executes a passenger update

Authorization: member admin superadmin

Attributes Type Authorization Description
travellers
optional
array Travellers of the booking
transaction_reference
optional
string Reference of the transactiona associated to the booking
expected_penalty
optional
number The expected penalty of the operation
POST train-bookings/:train_booking_id/edit/price-changes

Adds new price change to a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string Type of the reference on the price change
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
POST train-bookings/:booking_id/edit/attachments

Update booking fare section adding the attachment info file

Authorization:

Attributes Type Authorization Description
attachment
required
file The attachment of the train
GET train-bookings/:train_booking_id/edit/price-changes

Get booking price changes section

Authorization:

PUT train-bookings/:train_booking_id/edit/price-changes/:price_change_id

Updates a price change from a booking

Authorization:

Attributes Type Authorization Description
reference
optional
string Reference of price change
reference_id
optional
string The id of the reference
reference_type
optional
string Type of the reference on the price change
amount
optional
number The amount of the price change
date
optional
string The date when the price change occurs
reference_transaction
optional
string The id of the transaction
type
optional
string The type of the price change
DELETE train-bookings/:train_booking_id/edit/price-changes/:price_change_id

Delete a price change from a booking

Authorization:

POST train-bookings/:train_booking_id/edit/price-changes/confirm

Confirm all price changes that are in draft status

Authorization:

POST train-bookings/:train_booking_id/edit/price-changes/discard

Discard all price changes that are in draft status

Authorization:

POST trains/solutions/searches

Create a train search session

Authorization:

Attributes Type Authorization Description
passengers
required
array Array with all passengers informations.
locale
required
string The locale for the language of the results contents.
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
INVALID_DEPARTURE_DATE The departure date is invalid. Be sure the departure date and time are after the current timing.
INVALID_ARRIVAL_DATE The arrival date is invalid. Be sure the arrival date and time are after the departure timing.
GET trains/solutions/searches/:search_id

Get trains search session results

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price
train_carriers
optional
string Filter by train_carriers ids
price
optional
string Filter by price range.
trip_departure_times
optional
string Filter by trips departure times. It accepts comma separated values in minutes
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST trains/fares/searches

Create a train search fares session

Authorization:

Attributes Type Authorization Description
account_id
Required only for superadmins
string superadmin The account_id context
search_solution_id
required
string A search solution id
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET trains/fares/searches/:search_id

Get train search fares update

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
limit
optional
number Number of results.
offset
optional
number Results left margin
sort
optional
string Define the sortings rules. Sortable fields: price.
price
optional
string Filter by price range.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST trains/fares

Create a fare

Authorization:

Attributes Type Authorization Description
search_fare_ids
required
array A search fare ids.
discount_codes
optional
array objects of discount codes.
locale
required
string The locale for the language of the results contents.
leg_ids
optional
array The list of leg ids
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET trains/fares/:fare_id

Get a fare

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET trains/fares/:fare_id/seatmap

Get a seatMap info

Authorization:

Attributes Type Authorization Description
locale
required
string The locale for the language of the results contents.
account_id
optional
string Id of the account
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET trains/search/:sid

Get a details of a train search session

Authorization: member admin app superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
locale
required
string The locale for the language of the results contents.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST trains/search

Create a trains search session

Authorization: member admin app superadmin

Attributes Type Authorization Description
departure_station
required
string Departure station id.
arrival_station
required
string Arrival station id.
departure_date
required
string Departure date.
departure_time
required
string Departure time.
return_date
optional
string Return date.
return_time
optional
string Return time.
passengers
required
array An array containing every passenger age.
locale
required
string The locale for the language of the results contents.
account_id
optional
string superadmin The account_id context
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
INVALID_DEPARTURE_DATE The departure date is invalid. Be sure the departure date and time are after the current timing.
INVALID_PASSENGER_TYPE Invalid passenger type.
INVALID_PASSENGER_AGE Invalid passenger type.
GET travel-documents

Get users travel documents list.

Authorization:

Attributes Type Authorization Description
limit
optional
integer Number of results to return
offset
optional
integer Index of the result to start to return results
account_id
optional
string superadmin Filter by account_id
user_id
optional
string admin,superadmin Filter by user_id
type
optional
string Filter travel documents by type
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET travel-documents/:travel_document_id

Get the travel document detail.

Authorization: member admin superadmin

PUT travel-documents/:travel_document_id

Update an user travel document.

Authorization:

Attributes Type Authorization Description
type
optional
string The travel document type.
number
optional
string The travel document number.
expiration
optional
string The travel document expiration date.
country
optional
string The travel document country of emission.
issue_city
optional
string The travel document city of emission.
issue_date
optional
string The travel document date of emission.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST travel-documents/:travel_document_id/document-image

Upload multiple images for a travel document.

Authorization:

Attributes Type Authorization Description
document_image
optional
array Images of the travel document
Errors codes
MAX_BYTES_EXCEEDED You are trying to upload a file that exceed the maximum bytes allowed.
INVALID_FILE_FORMAT You are trying to upload an invalid file type.
DELETE travel-documents/:travel_document_id

Remove an user travel document.

Authorization:

GET users/available-payment-methods

Get the user available payment methods

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
optional
string superadmin The account_id context
is_personal
optional
boolean member,admin,superadmin Returns only user's personal cards
merchant
optional
string The merchant of the current booking/fare. If it is 'external' paypal & postpay will be hided
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST users

Add an user.

Authorization: member admin superadmin

Attributes Type Authorization Description
account_id
required for guest
string The account_id to join the user
first_name
required
string The first name of the user.
last_name
required
string The last name of the user.
role_id
optional
string The user role.
group_id
optional
null|string The user group id.
phone
optional
string The phone of the user.
contact_email
optional
string The contact email of the user.
employee_number
optional
string The employee registration number of the user.
position
optional
string The position of the user.
birthday
optional
string The birthday of the user.
gender
optional
string The gender of the user.
nationality
optional
string The nationality of the user.
email
optional
string The email of the user.
password
optional
string The password of the user.
default_locale
optional
string The default locale of the user.
default_currency
optional
string admin,superadmin The default currency of the user.
cpa_permissions
optional
array superadmin The array of permissions for the CPA.
lead_ref
optional
string The lead reference.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
NOT_ACTIVE The resource you are trying to use is not active.
EMAIL_ALREADY_USED The email you are trying to use is already in use.
POST users/:user_id/invite

Invite an user to register.

Authorization:

Attributes Type Authorization Description
email
optional
string The email of the user to invite.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
AUTHORIZATION_FAILED You are not authorized to do this operation or get this info.
NOT_FOUND The resource you are trying to get not exists.
NOT_ACTIVE The resource you are trying to use is not active.
EMAIL_ALREADY_USED The email you are trying to use is already in use.
PUT users/:user_id

Update an user.

Authorization: member admin superadmin

Attributes Type Authorization Description
first_name
optional
string The first name of the user.
last_name
optional
string The last name of the user.
full_name
optional
string The full name of the user.
traveller_first_name
optional
string The traveller first name of the user.
traveller_last_name
optional
string The traveller last name of the user.
role_id
optional
string The user role.
group_id
optional
null|string The user group id.
phone
optional
string The phone of the user.
employee_number
optional
string The employee registration number of the user.
position
optional
string The position of the user.
birthday
optional
string The birthday of the user.
gender
optional
string The gender of the user.
nationality
optional
string The nationality of the user.
email
optional
string The email of the user.
contact_email
optional
string The contact email of the user.
default_locale
optional
string The default locale of the user.
default_format_date
optional
object The format date settings for user display dates on platform.
default_currency
optional
string The default currency of the user.
default_bill_address_id
optional
null|string The default bill address of the user.
default_invoice_profile_id
optional
null|string The default invoice profile of the user.
password
optional
string superadmin The user password.
internal_notifications
optional
array superadmin The superadmin internal notification configs.
disabled_notifications
optional
array Notifications configuration for the user ( opt-out )
notifications_transports_config
optional
object superadmin The superadmin internal notification transports configs.
cpa_permissions
optional
array superadmin The array of permissions for the CPA.
notes.customer_service
optional
string superadmin Some account customer service notes.
notes.commercial
optional
string superadmin Some account commercial notes.
notes.general
optional
string superadmin Some account general notes.
is_temporary
optional
boolean superadmin Is temporary flag
user_ref_ext
optional
string superadmin External reference
tax_code
optional
string Tax code of the user
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
GET users/:user_id/travel-documents

Get the user travel documents list.

Authorization: member admin superadmin

POST ext/users/:user_id/cards

[Called by Proxy] Create an user card, with VGS Vault

Authorization:

Attributes Type Authorization Description
name
required
string The name of the card.
cvv
required
string CVV of the card.
expiration_date
required
object Expiration of the card
holder_name
required
string Holder name date of the card
number
required
string Number of the card
default_bill_address_id
optional
null|string The id of the adress id.
default_invoice_profile_id
optional
null|string The invoice profile id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST users/:user_id/cards

Create an user card.

Authorization:

Attributes Type Authorization Description
nonce
required
string The card nonce.
name
required
string The name of the card.
default_bill_address_id
optional
null|string The id of the adress id.
default_invoice_profile_id
optional
null|string The invoice profile id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
POST ext/users/:user_id/cards/:card_id/vaults

[Called by Proxy] Add Vaults of an user card.

Authorization:

Attributes Type Authorization Description
cvv
optional
string CVV of the card.
expiration_date
optional
object Expiration of the card
holder_name
optional
string Holder name date of the card
number
optional
string Number of the card
Errors codes
VALIDATION_FAILED Validation of the parameters failed.
INVALID_CARD_CC Invalid credit card.
PUT users/:user_id/cards/:card_id

Edit an user card.

Authorization:

Attributes Type Authorization Description
name
optional
string The name of the card.
default_bill_address_id
optional
null|string The id of the adress id.
default_invoice_profile_id
optional
null|string The invoice profile id.
Errors codes
VALIDATION_FAILED Validation of the parameters failed.