Skip to content
API Reference/
/
Search bookings

MeetingPackage Distribution API (1.0.0)

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

Download OpenAPI description
distro-openapi.json
distro-openapi.yaml
Overview
E-mail
integrations@meetingpackage.com
License
Internal
Terms of Service
Languages
Servers
Mock server
https://developers.meetingpackage.com/_mock/openapi/distro-openapi
Production
https://api.meetingpackage.co
Sandbox
https://sandbox.meetingpackage.co

Configuration

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

Operations

Bookings

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

Operations

Get booking details

Request

Retrieve an order/booking by ID and return extended order/booking information.

Security
ApiKeyAuth
Path
booking_idinteger(id)> 0required

Unique identifier of the booking

Example: 1234
curl -i -X GET \
  https://developers.meetingpackage.com/_mock/openapi/distro-openapi/v2/bookings/1234 \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Booking details

Bodyapplication/json
dataobjectrequired
data.​idinteger(id)> 0required

Unique identifier for an entity (such as venue or booking).

data.​created_atstring(date-time)required
data.​updated_atstring(date-time)required
data.​contentsArray of objectsrequired
data.​contents[].​price_without_taxinteger> 0required

A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).

Example: 115
data.​contents[].​price_with_taxinteger> 0

A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).

Example: 134
data.​contents[].​negotiated_rateobject
data.​contents[].​namestringrequired
data.​contents[].​revenue_detailsArray of objectsrequired
Example: [{"title":"Room Rental","price_without_tax":100,"price_with_tax":118,"negotiated_rate":{"discounts":[{"amount":100,"description":"50% discount for room hire when drinks ordered for 10 people.","type":"campaign"}],"original_price_without_tax":200,"original_price_with_tax":236}},{"title":"Service Fee","price_without_tax":10,"price_with_tax":13},{"title":"Tourist tax","price_without_tax":15,"price_with_tax":15}]
data.​contents[].​includesArray of objectsrequired

For DDR packages, will be array of package items. For addons, will be array of addon items.

data.​contents[].​categorystringrequired
Enum"menu""service""misc""accommodation""function-room"
data.​total_price_without_taxinteger(PriceValue)> 0required

A positive integer representing how much to charge in the smallest currency unit (e.g. 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).

data.​total_price_with_taxinteger(PriceValue)> 0

A positive integer representing how much to charge in the smallest currency unit (e.g. 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).

data.​total_discount_without_taxinteger(PriceValue)> 0required

A positive integer representing how much to charge in the smallest currency unit (e.g. 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).

data.​statusstringrequired

Order/booking status; May vary by configuration.

data.​status_updated_atstring(date-time)required
data.​currencystring(Currency)required

ISO 4217 currency code accepted by the venue (ref. https://en.wikipedia.org/wiki/ISO_4217)

data.​customer_idintegerrequired
Response
application/json
{
  "data": {
    "id": 1234,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "contents": [ … ],
    "total_price_without_tax": 100,
    "total_price_with_tax": 100,
    "total_discount_without_tax": 100,
    "status": "string",
    "status_updated_at": "2019-08-24T14:15:22Z",
    "currency": "EUR",
    "customer_id": 0
  }
}

Search bookings

Request

Search for orders/bookings by customer email.

Security
ApiKeyAuth
Query
email_idstring(email)required

Customer email address to search by.

Example: email_id=customer@example.com
curl -i -X GET \
  'https://developers.meetingpackage.com/_mock/openapi/distro-openapi/v2/bookings?email_id=customer%40example.com' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

List of orders/bookings associated with the provided customer email.

Bodyapplication/json
ordersArray of objects(BookingSummary)required

List of orders/bookings associated with the given customer email.

orders[].​order_idinteger(int64)required

Internal unique identifier for the order/booking.

Example: 123456
orders[].​rfp_parent_idstringrequired

Identifier linking this order/booking back to the parent RFP (group).

Example: "string"
orders[].​venue_idinteger(int64)required

Internal unique identifier of the venue.

Example: 25465
orders[].​statusstringrequired

Current status for the order/booking. Values may vary by configuration.

Example: "string"
Response
application/json
{
  "orders": [
    { … }
  ]
}

RFP

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

Operations

Webhooks

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

Webhooks