# MeetingPackage Distribution API

The MeetingPackage Distribution API enables partners to search availability, create and manage bookings, issue RFPs, and receive real-time updates from MeetingPackage.

Version: 1.0.0
License: Proprietary

## Servers

Production
```
https://api.meetingpackage.co
```

Sandbox
```
https://sandbox.meetingpackage.co
```

## Security

### ApiKeyAuth

Type: apiKey
In: header
Name: X-API-KEY

## Download OpenAPI description

[MeetingPackage Distribution API](https://mp-distribution-api.redocly.app/_bundle/openapi/distro-openapi.yaml)

## Configuration

Operations related to system configuration, including fetching the list of all supported venues, and setting up event notification webhooks.

### Get venue configurations

 - [GET /v2/configuration/venues](https://mp-distribution-api.redocly.app/openapi/distro-openapi/configuration/getvenueconfigurations.md): Returns venue configurations for all venues active for your integration. Configuration includes the MeetingPackage venue ID, the external venue ID, the booking type, and the market segment.

## Bookings

Operations related to orders/bookings, including viewing, creating, modifying and cancelling.

### Get booking details

 - [GET /v2/bookings/{booking_id}](https://mp-distribution-api.redocly.app/openapi/distro-openapi/bookings/getbookingdetails.md): Retrieve an order/booking by ID and return extended order/booking information.

### Search bookings

 - [GET /v2/bookings](https://mp-distribution-api.redocly.app/openapi/distro-openapi/bookings/searchbookings.md): Search for orders/bookings by customer email.

## RFP

Operations related to **RFPs (Requests For Proposal)**. Note RFPs are also called **leads**, i.e. group sales leads.

### Send RFP (lead data)

 - [POST /v1/rfp/lead_data](https://mp-distribution-api.redocly.app/openapi/distro-openapi/rfp/sendrfplead.md): Submit RFP (Request For Proposal), also called a lead (group sales lead).

### Get RFP group orders

 - [GET /v1/rfp/{group_id}](https://mp-distribution-api.redocly.app/openapi/distro-openapi/rfp/getrfpgrouporders.md): Retrieve orders associated with an RFP parent (group) request. Use this after webhook events that reference an RFP ID / group ID, or to list all orders created for an RFP.

## Webhooks

Event notifications sent by MeetingPackage to partner endpoints. Use these to receive real-time updates rather than polling.

### Booking update

 - [POST bookingUpdate](https://mp-distribution-api.redocly.app/openapi/distro-openapi/webhooks/bookingupdatewebhook.md): Notification of a change to an order/booking. Call the relevant GET operation to fetch details about the order/booking.

### Venue visibility update

 - [POST venueVisibility](https://mp-distribution-api.redocly.app/openapi/distro-openapi/webhooks/venuevisibilityupdatewebhook.md): Notification of a change to venue visibility, i.e. whether the venue is active or not.