# Find a Booking by ID

This endpoint retrieves details for a specific booking, providing information such as booking status, party size, contact details, and special notes. This allows Mozrest to access booking information in real time.

## Endpoint

`GET https://partner-domain.com/v1/mozrest/booking/{bookingId}`

## URL Parameters

| Parameter | Status | Description |
|  --- | --- | --- |
| bookingId | **Mandatory** | Unique identifier for the booking in the partner's system. |


## Example Request


```shell
curl GET "https://partner-domain.com/v1/mozrest/booking/{bookingId}" \
  -H "Authorization: Bearer {{api_key}}"
```

## Example Response


```json
{
  "id": "60e890aca5f07b6ee5b950b1",
  "bookingChannel": {
    "id": "60e890aca5f07b6ee5b950b3",
    "name": "Channel Name"
  },
  "venueId": "60e890aca5f07b6ee5b950b1",
  "partySize": 4,
  "status": "confirmed",
  "date": "2021-11-07T12:00:00+02:00",
  "notes": "I'm alergic to peanuts and broccoli",
  "paymentGatewayToken":null,
  "contact": {
    "id": "60e890aca5f07b6ee5b950b1",
    "firstname": "John",
    "lastname": "Doe",
    "email": "john.doe@gmail.com",
    "telephone": "44344223322",
    "locale": "en",
    },
    "optInConsent": true
  }
}
```

## Response Definitions

- **id**: Unique identifier for the booking.
- **bookingChannel**: Object containing the booking channel’s **id** and **name**.
- **venueId**: Unique identifier for the venue in which the booking is made.
- **partySize**: Number of people for the reservation.
- **status**: Current status of the booking (e.g., "confirmed").
- **date**: Date and time of the booking in ISO 8601 format.
- **notes**: Special notes or requests made by the customer.
- **paymentGatewayToken**: Token if payment information was processed through a gateway.
- **contact**: Object containing contact details for the booking owner:
  - **id**: Unique identifier for the contact.
  - **firstname**: First name of the contact person.
  - **lastname**: Last name of the contact person.
  - **email**: Email address of the contact person.
  - **telephone**: Phone number of the contact person.
  - **locale**: Preferred language/locale of the contact.
  - **optInConsent**: Boolean indicating whether the contact has opted in for communications.