Redocly Museum API

https://redocly.github.io/redoc
Admin
An imaginary, but delightful Museum API for interacting with museum services and information, built...
Tokens:14,980
Snippets:52
Trust Score:8.3
Update:1 year ago
Show doc for...
Tokens:
Raw
### Untitled

No description

--------------------------------

### Get Special Event Response Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON response when retrieving information about a specific special event. It details the event's ID, name, location, description, multiple dates, and price.

```json
{
  "eventId": "6744a0da-4121-49cd-8479-f8cc20526495",
  "name": "Time Traveler Tea Party",
  "location": "Temporal Tearoom",
  "eventDescription": "Sip tea with important historical figures.",
  "dates": [
    "2023-11-18",
    "2023-11-25",
    "2023-12-02"
  ],
  "price": 60
}
```

--------------------------------

### Create Special Event Response Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON response after successfully creating a special event. It returns the event's ID, name, location, description, dates, and price.

```json
{
  "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
  "name": "Mermaid Treasure Identification and Analysis",
  "location": "Under the seaaa ðŸ¦€ ðŸŽ¶ ðŸŒŠ.",
  "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
  "dates": [
    "2023-09-05",
    "2023-09-08"
  ],
  "price": 30
}
```

--------------------------------

### Create Special Event Request Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON request to create a new special event. It includes the event name, location, description, dates, and price.

```json
{
  "name": "Mermaid Treasure Identification and Analysis",
  "location": "Under the seaaa ðŸ¦€ ðŸŽ¶ ðŸŒŠ.",
  "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
  "dates": [
    "2023-09-05",
    "2023-09-08"
  ],
  "price": 0
}
```

--------------------------------

### List Special Events Response Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON response when listing multiple special events. Each event object contains its ID, name, location, description, dates, and price.

```json
[
  {
    "eventId": "f3e0e76e-e4a8-466e-ab9c-ae36c15b8e97",
    "name": "Sasquatch Ballet",
    "location": "Seattle... probably",
    "eventDescription": "They're big, they're hairy, but they're also graceful. Come learn how the biggest feet can have the lightest touch.",
    "dates": [
      "2023-12-15",
      "2023-12-22"
    ],
    "price": 40
  },
  {
    "eventId": "2f14374a-9c65-4ee5-94b7-fba66d893483",
    "name": "Solar Telescope Demonstration",
    "location": "Far from the sun.",
    "eventDescription": "Look at the sun without going blind!",
    "dates": [
      "2023-09-07",
      "2023-09-14"
    ],
    "price": 50
  },
  {
    "eventId": "6aaa61ba-b2aa-4868-b803-603dbbf7bfdb",
    "name": "Cook like a Caveman",
    "location": "Fire Pit on East side",
    "eventDescription": "Learn to cook on an open flame.",
    "dates": [
      "2023-11-10",
      "2023-11-17",
      "2023-11-24"
    ],
    "price": 5
  },
  {
    "eventId": "602b75e1-5696-4ab8-8c7a-f9e13580f910",
    "name": "Underwater Basket Weaving",
    "location": "Rec Center Pool next door.",
    "eventDescription": "Learn to weave baskets underwater.",
    "dates": [
      "2023-09-12",
      "2023-09-15"
    ],
    "price": 15
  },
  {
    "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
    "name": "Mermaid Treasure Identification and Analysis",
    "location": "Room Sea-12"
  }
]
```

--------------------------------

### Special Event Ticket Purchase Response Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON response after successfully purchasing a special event ticket. It confirms the purchase, provides a ticket ID, event name, ticket type, date, and a confirmation code.

```json
{
  "message": "Museum special event ticket purchased",
  "ticketId": "b811f723-17b2-44f7-8952-24b03e43d8a9",
  "eventName": "Mermaid Treasure Identification and Analysis",
  "ticketType": "event",
  "ticketDate": "2023-09-05",
  "confirmationCode": "ticket-event-9c55eg-8v82a"
}
```

--------------------------------

### Special Event Ticket Purchase Request Example (JSON)

Source: https://redocly.github.io/redoc/museum

Example of a JSON request to purchase a ticket for a special event. It includes the ticket type, the specific event ID, the desired date, and the buyer's email.

```json
{
  "ticketType": "general",
  "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
  "ticketDate": "2023-09-05",
  "email": "todd@example.com"
}
```

--------------------------------

### GET /museum-hours

Source: https://redocly.github.io/redoc/index

Retrieves upcoming museum operating hours. Allows filtering by a start date and pagination.

```APIDOC
## GET /museum-hours

### Description
Get upcoming museum operating hours. Allows filtering by a start date and pagination.

### Method
GET

### Endpoint
https://api.fake-museum-example.com/v1/museum-hours

### Parameters
#### Query Parameters
- **startDate** (string <date>) - Optional - The starting date to retrieve future operating hours from. Defaults to today's date.
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **limit** (integer) - Optional - The number of days per page. Maximum value is 30. Defaults to 10.

### Responses
#### Success Response (200)
- **Museum opening hours** (object) - Details about the museum's opening hours.

#### Response Example
```json
[
  {
    "date": "2023-09-11",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  },
  {
    "date": "2023-09-12",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  }
]
```
```

--------------------------------

### GET /events

Source: https://redocly.github.io/redoc/museum

Retrieves a list of all upcoming special events.

```APIDOC
## GET /events

### Description
Retrieves a list of all upcoming special events.

### Method
GET

### Endpoint
/events

### Response
#### Success Response (200)
- The response is an array of special event objects, each containing:
  - **eventId** (string) - The unique identifier for the event.
  - **name** (string) - The name of the special event.
  - **location** (string) - The location of the special event.
  - **eventDescription** (string) - A description of the special event.
  - **dates** (array of strings) - An array of dates for the event in YYYY-MM-DD format.
  - **price** (number) - The price of the event ticket.

#### Response Example
```json
[
  {
    "eventId": "f3e0e76e-e4a8-466e-ab9c-ae36c15b8e97",
    "name": "Sasquatch Ballet",
    "location": "Seattle... probably",
    "eventDescription": "They're big, they're hairy, but they're also graceful. Come learn how the biggest feet can have the lightest touch.",
    "dates": [
      "2023-12-15",
      "2023-12-22"
    ],
    "price": 40
  },
  {
    "eventId": "2f14374a-9c65-4ee5-94b7-fba66d893483",
    "name": "Solar Telescope Demonstration",
    "location": "Far from the sun.",
    "eventDescription": "Look at the sun without going blind!",
    "dates": [
      "2023-09-07",
      "2023-09-14"
    ],
    "price": 50
  }
]
```
```

--------------------------------

### Get Museum Hours Response Sample (JSON)

Source: https://redocly.github.io/redoc/index

This snippet displays a successful response from the 'Get museum hours' endpoint. It includes a list of dates with their corresponding opening and closing times. This is useful for understanding the structure of the returned data.

```json
[
  {
    "date": "2023-09-11",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  },
  {
    "date": "2023-09-12",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  },
  {
    "date": "2023-09-13",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  },
  {
    "date": "2023-09-17",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  }
]
```

--------------------------------

### Untitled

No description

--------------------------------

### Create Special Event Request Sample (JSON)

Source: https://redocly.github.io/redoc/index

This snippet shows an example of a request payload for creating a special event. It includes all required fields such as name, location, description, dates, and price. This is crucial for correctly formatting requests to the 'Create special event' endpoint.

```json
{
  "name": "Mermaid Treasure Identification and Analysis",
  "location": "Under the seaaa 🦀 🎶 🌊.",
  "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
  "dates": [
    "2023-09-05",
    "2023-09-08"
  ],
  "price": 0
}
```

--------------------------------

### GET /museum/events

Source: https://redocly.github.io/redoc/museum

Retrieves a list of special events offered by the museum. Supports pagination.

```APIDOC
## GET /museum/events

### Description
Retrieves a list of special events offered by the museum. Supports pagination.

### Method
GET

### Endpoint
/museum/events

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **limit** (integer) - Optional - The number of events per page. Defaults to 10. Maximum is 30.

### Request Example
```json
{
  "example": "GET /museum/events?page=1&limit=10"
}
```

### Response
#### Success Response (200)
- **eventId** (string) - Unique identifier for the event.
- **name** (string) - The name of the event.
- **location** (string) - The location of the event within the museum.
- **eventDescription** (string) - A description of the event.
- **dates** (array of strings) - List of dates the event is held.
- **price** (integer) - The price of the event ticket.

#### Response Example
```json
{
  "example": [
    {
      "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
      "name": "Mermaid Treasure Identification and Analysis",
      "location": "On the beach.",
      "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
      "dates": [
        "2023-09-05",
        "2023-09-08"
      ],
      "price": 15
    }
  ]
}
```
```

--------------------------------

### Untitled

No description

--------------------------------

### GET /museum/hours

Source: https://redocly.github.io/redoc/museum

Retrieves the operating hours for the museum for consecutive days.

```APIDOC
## GET /museum/hours

### Description
Retrieves the operating hours for the museum for consecutive days.

### Method
GET

### Endpoint
/museum/hours

### Response
#### Success Response (200)
- **(array)** - A list of museum operating hours for consecutive days.
  - **date** (Date) - The date the operating hours apply to.
  - **timeOpen** (string) - The time the museum opens on a specific date. Uses 24 hour time format (`HH:mm`).
  - **timeClose** (string) - The time the museum closes on a specific date. Uses 24 hour time format (`HH:mm`).

#### Response Example
```json
[
  {
    "date": "2024-12-31",
    "timeOpen": "09:00",
    "timeClose": "18:00"
  },
  {
    "date": "2025-01-01",
    "timeOpen": "10:00",
    "timeClose": "17:00"
  }
]
```
```

--------------------------------

### GET /events/{eventId}

Source: https://redocly.github.io/redoc/museum

Retrieves details for a specific special event.

```APIDOC
## GET /events/{eventId}

### Description
Retrieves details for a specific special event.

### Method
GET

### Endpoint
/events/{eventId}

### Parameters
#### Path Parameters
- **eventId** (string) - Required - The unique identifier of the special event.

### Response
#### Success Response (200)
- **eventId** (string) - The unique identifier for the event.
- **name** (string) - The name of the special event.
- **location** (string) - The location of the special event.
- **eventDescription** (string) - A description of the special event.
- **dates** (array of strings) - An array of dates for the event in YYYY-MM-DD format.
- **price** (number) - The price of the event ticket.

#### Response Example
```json
{
  "eventId": "6744a0da-4121-49cd-8479-f8cc20526495",
  "name": "Time Traveler Tea Party",
  "location": "Temporal Tearoom",
  "eventDescription": "Sip tea with important historical figures.",
  "dates": [
    "2023-11-18",
    "2023-11-25",
    "2023-12-02"
  ],
  "price": 60
}
```
```

--------------------------------

### Get Ticket QR Code

Source: https://redocly.github.io/redoc/museum

Retrieves an image of a ticket with a scannable QR code, used for event entry.

```APIDOC
## GET /tickets/{ticketId}/qr

### Description
Return an image of your ticket with scannable QR code. Used for event entry.

### Method
GET

### Endpoint
/tickets/{ticketId}/qr

### Parameters
#### Path Parameters
- **ticketId** (string) - Required - The unique identifier of the ticket.

### Response
#### Success Response (200)
- The response body will be an image (PNG format) of the ticket with a QR code.

#### Error Responses
- **400**: Bad request
- **404**: Not found
```

--------------------------------

### GET /special-events

Source: https://redocly.github.io/redoc/museum

Retrieves a list of upcoming special events at the museum. Supports date range and pagination.

```APIDOC
## GET /special-events

### Description
Return a list of upcoming special events at the museum.

### Method
GET

### Endpoint
/special-events

### Parameters
#### Query Parameters
- **startDate** (string) - Optional - The starting date to retrieve future operating hours from. Defaults to today's date.
- **endDate** (string) - Optional - The end of a date range to retrieve special events for. Defaults to 7 days after `startDate`.
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **limit** (integer) - Optional - The number of days per page. Defaults to 10, maximum 30.

### Request Example
```json
{
  "example": "GET /special-events?startDate=2023-09-10&endDate=2023-09-20&page=1&limit=10"
}
```

### Response
#### Success Response (200)
- **events** (array) - A list of special events.
  - **eventId** (string) - The unique identifier for the special event.
  - **name** (string) - The name of the special event.
  - **date** (string) - The date of the special event.
  - **description** (string) - A description of the special event.

#### Response Example
```json
{
  "example": {
    "events": [
      {
        "eventId": "evt_abcde",
        "name": "Summer Art Exhibition",
        "date": "2023-09-15",
        "description": "Showcasing contemporary art from local artists."
      },
      {
        "eventId": "evt_fghij",
        "name": "Classical Music Night",
        "date": "2023-09-18",
        "description": "An evening of enchanting classical music."
      }
    ]
  }
}
```
```

--------------------------------

### GET /special-events/{eventId}

Source: https://redocly.github.io/redoc/museum

Retrieves detailed information about a specific special event.

```APIDOC
## GET /special-events/{eventId}

### Description
Get details about a special event.

### Method
GET

### Endpoint
/special-events/{eventId}

### Parameters
#### Path Parameters
- **eventId** (string) - Required - The unique identifier of the special event.

### Request Example
```json
{
  "example": "GET /special-events/evt_abcde"
}
```

### Response
#### Success Response (200)
- **eventId** (string) - The unique identifier for the special event.
- **name** (string) - The name of the special event.
- **date** (string) - The date of the special event.
- **description** (string) - A detailed description of the special event.
- **startTime** (string) - The start time of the event.
- **endTime** (string) - The end time of the event.

#### Response Example
```json
{
  "example": {
    "eventId": "evt_abcde",
    "name": "Summer Art Exhibition",
    "date": "2023-09-15",
    "description": "Showcasing contemporary art from local artists. This exhibition features a diverse range of styles and mediums.",
    "startTime": "10:00",
    "endTime": "17:00"
  }
}
```
```

--------------------------------

### GET /tickets/{ticketId}/qr

Source: https://redocly.github.io/redoc/museum

Retrieves the QR code image for a specific museum ticket.

```APIDOC
## GET /tickets/{ticketId}/qr

### Description
Retrieves the QR code image for a specific museum ticket.

### Method
GET

### Endpoint
/tickets/{ticketId}/qr

### Parameters
#### Path Parameters
- **ticketId** (string) - Required - The unique identifier of the ticket.

### Response
#### Success Response (200)
- **(binary)** - An image of a ticket with a QR code used for museum or event entry.

#### Response Example
(Binary image data)
```

--------------------------------

### GET /museum/hours

Source: https://redocly.github.io/redoc/museum

Retrieves the museum's operating hours for a specified date range.

```APIDOC
## GET /museum/hours

### Description
Retrieves the museum's operating hours for a specified date range.

### Method
GET

### Endpoint
/museum/hours

### Parameters
#### Query Parameters
- **startDate** (string) - Optional - The starting date to retrieve future operating hours from. Defaults to today's date.
- **endDate** (string) - Optional - The end of a date range to retrieve operating hours for. Defaults to 7 days after `startDate`.

### Request Example
```json
{
  "example": "GET /museum/hours?startDate=2023-09-11&endDate=2023-09-15"
}
```

### Response
#### Success Response (200)
- **date** (string) - The date for which the hours are provided.
- **timeOpen** (string) - The opening time for the specified date.
- **timeClose** (string) - The closing time for the specified date.

#### Response Example
```json
{
  "example": [
    {
      "date": "2023-09-11",
      "timeOpen": "09:00",
      "timeClose": "18:00"
    },
    {
      "date": "2023-09-12",
      "timeOpen": "09:00",
      "timeClose": "18:00"
    }
  ]
}
```
#### Special Case: Closed Museum Hours (Example)
If the museum is closed on a specific day, an empty array may be returned or a specific indicator.

#### Response Example (Closed)
```json
{
  "example": []
}
```
```

--------------------------------

### GET /museum-hours

Source: https://redocly.github.io/redoc/museum

Retrieves upcoming museum operating hours. Supports pagination and date filtering.

```APIDOC
## GET /museum-hours

### Description
Get upcoming museum operating hours.

### Method
GET

### Endpoint
/museum-hours

### Parameters
#### Query Parameters
- **startDate** (string) - Optional - The starting date to retrieve hours from. Defaults to today's date.
- **page** (integer) - Optional - The page number for pagination. Defaults to 1.
- **limit** (integer) - Optional - The number of items per page. Defaults to 10, maximum 30.

### Request Example
```json
{
  "example": "GET /museum-hours?startDate=2023-09-10&page=1&limit=10"
}
```

### Response
#### Success Response (200)
- **date** (string) - The date of the operating hours.
- **timeOpen** (string) - The opening time for the specified date.
- **timeClose** (string) - The closing time for the specified date.

#### Response Example
```json
{
  "example": [
    {
      "date": "2023-09-11",
      "timeOpen": "09:00",
      "timeClose": "18:00"
    },
    {
      "date": "2023-09-12",
      "timeOpen": "09:00",
      "timeClose": "18:00"
    }
  ]
}
```
```

--------------------------------

### GET /v1/tickets/{ticketId}/qr

Source: https://redocly.github.io/redoc/index

Returns an image of your ticket with a scannable QR code. Used for event entry.

```APIDOC
## Get Ticket QR Code

### Description
Returns an image of your ticket with a scannable QR code. Used for event entry.

### Method
GET

### Endpoint
/v1/tickets/{ticketId}/qr

### Parameters
#### Path Parameters
- **ticketId** (string) - Required - An identifier for a ticket to a museum event. Used to generate ticket image.

### Response
#### Success Response (200)
Scannable event ticket in image format

#### Error Responses
- **400** - Bad request
- **404** - Not found
```

--------------------------------

### Get Special Event Details (JSON Response Sample)

Source: https://redocly.github.io/redoc/index

This JSON snippet shows a successful response for retrieving details of a specific special event. It includes all the information for a single event, identified by its unique eventId. This is useful for displaying event-specific data.

```json
{
  "eventId": "6744a0da-4121-49cd-8479-f8cc20526495",
  "name": "Time Traveler Tea Party",
  "location": "Temporal Tearoom",
  "eventDescription": "Sip tea with important historical figures.",
  "dates": [
    "2023-11-18",
    "2023-11-25",
    "2023-12-02"
],
  "price": 60

}
```

--------------------------------

### GET /special-events

Source: https://redocly.github.io/redoc/index

Retrieves a list of upcoming special events at the museum. Supports filtering by date range and pagination.

```APIDOC
## GET /special-events

### Description
Retrieves a list of upcoming special events at the museum. Supports filtering by date range and pagination.

### Method
GET

### Endpoint
https://api.fake-museum-example.com/v1/special-events

### Parameters
#### Query Parameters
- **startDate** (string <date>) - Optional - The starting date to retrieve future operating hours from. Defaults to today's date.
- **endDate** (string <date>) - Optional - The end of a date range to retrieve special events for. Defaults to 7 days after `startDate`.
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **limit** (integer) - Optional - The number of days per page. Maximum value is 30. Defaults to 10.

### Responses
#### Success Response (200)
- **List of upcoming special events** (array) - An array of special event objects.

#### Response Example
```json
[
  {
    "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
    "name": "Mermaid Treasure Identification and Analysis",
    "location": "Under the seaaa 🦀 🎶 🌊.",
    "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
    "dates": [
      "2023-09-05",
      "2023-09-08"
    ],
    "price": 30
  }
]
```
```

--------------------------------

### Get Special Event by ID

Source: https://redocly.github.io/redoc/index

Retrieves detailed information about a specific special event using its unique event ID.

```APIDOC
## Get Special Event by ID

### Description
Retrieves detailed information about a specific special event using its unique event ID.

### Method
GET

### Endpoint
/v1/special-events/{eventId}

### Parameters
#### Path Parameters
- **eventId** (string) - Required - An identifier for a special event. Example: dad4bce8-f5cb-4078-a211-995864315e39

### Response
#### Success Response (200)
- **eventId** (string) - A unique identifier for the event.
- **name** (string) - The name of the event.
- **location** (string) - The location where the event will be held.
- **eventDescription** (string) - A detailed description of the event.
- **dates** (array of strings) - A list of dates when the event will take place.
- **price** (number) - The price of a ticket for the event.

#### Response Example
```json
{
  "eventId": "6744a0da-4121-49cd-8479-f8cc20526495",
  "name": "Time Traveler Tea Party",
  "location": "Temporal Tearoom",
  "eventDescription": "Sip tea with important historical figures.",
  "dates": [
    "2023-11-18",
    "2023-11-25",
    "2023-12-02"
  ],
  "price": 60
}
```
```

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### Untitled

No description

--------------------------------

### POST /tickets/general

Source: https://redocly.github.io/redoc/museum

Purchases a general entry ticket for the museum.

```APIDOC
## POST /tickets/general

### Description
Purchases a general entry ticket for the museum.

### Method
POST

### Endpoint
/tickets/general

### Parameters
#### Request Body
- **ticketType** (string) - Required - The type of ticket, must be 'general'.
- **ticketDate** (string) - Required - The date for the ticket in YYYY-MM-DD format.
- **email** (string) - Required - The email address of the purchaser.

### Request Example
```json
{
  "ticketType": "general",
  "ticketDate": "2023-09-07",
  "email": "todd@example.com"
}
```

### Response
#### Success Response (200)
- **message** (string) - A confirmation message.
- **ticketId** (string) - The unique identifier for the purchased ticket.
- **ticketType** (string) - The type of ticket purchased.
- **ticketDate** (string) - The date for which the ticket is valid.
- **confirmationCode** (string) - A code for ticket confirmation.

#### Response Example
```json
{
  "message": "Museum general entry ticket purchased",
  "ticketId": "382c0820-0530-4f4b-99af-13811ad0f17a",
  "ticketType": "general",
  "ticketDate": "2023-09-07",
  "confirmationCode": "ticket-general-e5e5c6-dce78"
}
```
```

--------------------------------

### Untitled

No description

--------------------------------

### POST /events

Source: https://redocly.github.io/redoc/museum

Creates a new special event at the museum.

```APIDOC
## POST /events

### Description
Creates a new special event at the museum.

### Method
POST

### Endpoint
/events

### Parameters
#### Request Body
- **name** (EventName) - Required - The name of the event.
- **location** (EventLocation) - Required - The location where the event is held.
- **eventDescription** (EventDescription) - Required - A description of the event.
- **dates** (EventDates) - Required - A list of planned dates for the event.
- **price** (EventPrice) - Required - The price of a ticket for the event.

### Request Example
```json
{
  "name": "Pirate Coding Workshop",
  "location": "Computer Room",
  "eventDescription": "Captain Blackbeard shares his love of the C...language. And possibly Arrrrr (R lang).",
  "dates": ["2025-02-15", "2025-02-16"],
  "price": 25.00
}
```

### Response
#### Success Response (200)
- **eventId** (EventId) - The unique identifier for the newly created event.

#### Response Example
```json
{
  "eventId": "3be6453c-03eb-4357-ae5a-984a0e574a54"
}
```
```

--------------------------------

### POST /events

Source: https://redocly.github.io/redoc/museum

Creates a new special event at the museum.

```APIDOC
## POST /events

### Description
Creates a new special event at the museum.

### Method
POST

### Endpoint
/events

### Parameters
#### Request Body
- **name** (string) - Required - The name of the special event.
- **location** (string) - Required - The location of the special event.
- **eventDescription** (string) - Required - A description of the special event.
- **dates** (array of strings) - Required - An array of dates for the event in YYYY-MM-DD format.
- **price** (number) - Required - The price of the event ticket.

### Request Example
```json
{
  "name": "Mermaid Treasure Identification and Analysis",
  "location": "Under the seaaa ðŸ¦€ ðŸŽ¶ ðŸŒŠ.",
  "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
  "dates": [
    "2023-09-05",
    "2023-09-08"
  ],
  "price": 0
}
```

### Response
#### Success Response (200)
- **eventId** (string) - The unique identifier for the created event.
- **name** (string) - The name of the special event.
- **location** (string) - The location of the special event.
- **eventDescription** (string) - A description of the special event.
- **dates** (array of strings) - An array of dates for the event in YYYY-MM-DD format.
- **price** (number) - The price of the event ticket.

#### Response Example
```json
{
  "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
  "name": "Mermaid Treasure Identification and Analysis",
  "location": "Under the seaaa ðŸ¦€ ðŸŽ¶ ðŸŒŠ.",
  "eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",
  "dates": [
    "2023-09-05",
    "2023-09-08"
  ],
  "price": 30
}
```
```

--------------------------------

### POST /special-events

Source: https://redocly.github.io/redoc/museum

Creates a new special event at the museum.

```APIDOC
## POST /special-events

### Description
Create a special event.

### Method
POST

### Endpoint
/special-events

### Parameters
#### Request Body
- **field1** (type) - Required/Optional - Description of the field.

### Request Example
```json
{
  "example": "{\"name\": \"New Year's Gala\", \"date\": \"2024-01-01\", \"description\": \"A spectacular celebration for the New Year!\"}"
}
```

### Response
#### Success Response (200)
- **eventId** (string) - The unique identifier for the newly created special event.
- **message** (string) - A confirmation message.

#### Response Example
```json
{
  "example": "{\"eventId\": \"evt_12345\", \"message\": \"Special event created successfully.\"}"
}
```
```

--------------------------------

### POST /tickets/events

Source: https://redocly.github.io/redoc/museum

Purchases a ticket for a special event at the museum.

```APIDOC
## POST /tickets/events

### Description
Purchases a ticket for a special event at the museum.

### Method
POST

### Endpoint
/tickets/events

### Parameters
#### Request Body
- **ticketType** (string) - Required - The type of ticket, must be 'event'.
- **eventId** (string) - Required - The ID of the special event.
- **ticketDate** (string) - Required - The date for the ticket in YYYY-MM-DD format.
- **email** (string) - Required - The email address of the purchaser.

### Request Example
```json
{
  "ticketType": "general",
  "eventId": "dad4bce8-f5cb-4078-a211-995864315e39",
  "ticketDate": "2023-09-05",
  "email": "todd@example.com"
}
```

### Response
#### Success Response (200)
- **message** (string) - A confirmation message.
- **ticketId** (string) - The unique identifier for the purchased ticket.
- **eventName** (string) - The name of the special event.
- **ticketType** (string) - The type of ticket purchased.
- **ticketDate** (string) - The date for which the ticket is valid.
- **confirmationCode** (string) - A code for ticket confirmation.

#### Response Example
```json
{
  "message": "Museum special event ticket purchased",
  "ticketId": "b811f723-17b2-44f7-8952-24b03e43d8a9",
  "eventName": "Mermaid Treasure Identification and Analysis",
  "ticketType": "event",
  "ticketDate": "2023-09-05",
  "confirmationCode": "ticket-event-9c55eg-8v82a"
}
```
```
Tokens:
Raw