# Bookings

Bookings information

## Get bookings list

 - [GET /bookings](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings/get.md)

## Find booking by ID

 - [GET /bookings/{bookingId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D/get.md)

## Update/create booking by ID

 - [PUT /bookings/{bookingId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D/put.md)

## Delete booking by ID

 - [DELETE /bookings/{bookingId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D/delete.md)

## Get the integration status of a batch

 - [GET /bookings/requestsStatus/batch/{batchId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1requestsstatus~1batch~1%7Bbatchid%7D/get.md)

## Get the integration status of a booking

 - [GET /bookings/requestsStatus/booking/{bookingId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1requestsstatus~1booking~1%7Bbookingid%7D/get.md)

## Get events in booking by bookingId

 - [GET /bookings/{bookingId}/events](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1events/get.md)

## Find event by ID

 - [GET /bookings/{bookingId}/events/{eventId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1events~1%7Beventid%7D/get.md)

## Update/create event by ID

 - [PUT /bookings/{bookingId}/events/{eventId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1events~1%7Beventid%7D/put.md)

## Mark event as canceled by ID

 - [DELETE /bookings/{bookingId}/events/{eventId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1events~1%7Beventid%7D/delete.md)

## Get booking attachments metadata

 - [GET /bookings/{bookingId}/attachments](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1attachments/get.md)

## Add attachment to booking

 - [PUT /bookings/{bookingId}/attachments/{attachmentId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1attachments~1%7Battachmentid%7D/put.md)

## Delete booking attachment by ID

 - [DELETE /bookings/{bookingId}/attachments/{attachmentId}](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1attachments~1%7Battachmentid%7D/delete.md)

## DEPRECATED, use PUT instead - create new booking (deprecated)

 - [POST /bookings](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings/post.md)

## DEPRECATED, use PUT instead - update/create bookings bulk (deprecated)

 - [POST /bookings/bulk](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1bulk/post.md)

## DEPRECATED, use PUT instead - create and event for a booking (deprecated)

 - [POST /bookings/{bookingId}/events](https://developer.m2x.app/apis/publicapi/openapi/bookings/paths/~1bookings~1%7Bbookingid%7D~1events/post.md)

## Bookings (carrier allocation webhook)

 - [POST Booking](https://developer.m2x.app/apis/publicapi/openapi/bookings/bookingwebhook.md): Webhook type: BOOKING

### Overview

This webhook provides notifications of changes to bookings that have been allocated to a carrier. It provides the subscriber with the full Booking entity, and enables downstream processes such as reporting and tracking.

### Trigger Conditions

This webhook is triggered when:
- The booking is allocated to a carrier through the enterprise platform, either via manual assignment or automated workflow.
- Any update is made to the booking through the enterprise environment whilst the carrier is allocated.

## Corporate booking event webhook

 - [POST Booking Event](https://developer.m2x.app/apis/publicapi/openapi/bookings/factswebhook.md): webhook type: FACT

### Overview

This webhook allows you to receive notifications when booking events are created or updated. This could be due to changes made in the carrier TMS, mobile app, or in external systems via the M2X API.

Possible event types are listed in the description of the event field of the payload.

### Trigger Conditions

This webhook is triggered when:
- A booking event is created or updated.  See below for the list of possible events.