Skip to main content
GET
/
events
Get All Events
curl --request GET \
  --url http://localhost:50001/events
{
  "events": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "eventDate": "<string>",
      "basePrice": 123
    }
  ]
}

​
Overview

This endpoint returns all events in the catalog. Each event includes basic information such as name, description, date, and base price, but does not include seat availability or seatmap details. Use this endpoint to display a list of events to users. For detailed seat information, use the Get Event Seatmap endpoint.

​
Authentication

No authentication required. This is a public endpoint.

​
Response

​
events
array
Array of event objects

​
Example Request

curl -X GET http://localhost:50001/events \
  -H "Content-Type: application/json"

​
Example Response

200 OK
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Coldplay - Live in Santiago",
    "description": "World tour 2026",
    "eventDate": "2026-03-15T19:00:00Z",
    "basePrice": 50.00
  },
  {
    "id": "650e8400-e29b-41d4-a716-446655440001",
    "name": "Taylor Swift - The Eras Tour",
    "description": "Experience all musical eras in one unforgettable night",
    "eventDate": "2026-04-20T20:00:00Z",
    "basePrice": 75.00
  },
  {
    "id": "750e8400-e29b-41d4-a716-446655440002",
    "name": "Ed Sheeran - Mathematics Tour",
    "description": "Intimate acoustic performance",
    "eventDate": "2026-05-10T19:30:00Z",
    "basePrice": 60.00
  }
]

​
Error Responses

Server encountered an unexpected error while processing the request.
{
  "error": "Internal server error",
  "message": "An unexpected error occurred while fetching events"
}

​
Notes

  • All prices are in USD
  • Event dates are returned in UTC timezone (ISO 8601 format)
  • This endpoint does not include seat availability information
  • For seat details, use GET /events//seatmap
  • The endpoint returns an empty array [] if no events exist in the system

Build docs developers (and LLMs) love

Get started for freeTalk to us