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

Overview

This endpoint returns detailed information about a specific event identified by its UUID. The response includes the event’s name, description, date, and base price, but does not include seat availability or seatmap information. For detailed seat information, use the Get Event Seatmap endpoint instead.

Authentication

No authentication required. This is a public endpoint.

Path Parameters

id
string
required
The unique identifier (UUID) of the event to retrieve.Example: 550e8400-e29b-41d4-a716-446655440000

Response

id
string
required
Unique identifier for the event (UUID format)
name
string
required
Name of the event
description
string
required
Detailed description of the event
eventDate
string
required
Date and time of the event (ISO 8601 format in UTC)
basePrice
number
required
Base price for tickets to this event

Example Request

curl -X GET http://localhost:50001/events/550e8400-e29b-41d4-a716-446655440000 \
  -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
}

Error Responses

The event with the specified ID does not exist in the system.The endpoint returns HTTP 404 with no response body when the event is not found.
The provided event ID is not in a valid UUID format.
{
  "error": "Invalid event ID format",
  "message": "The event ID must be a valid UUID"
}
Server encountered an unexpected error while processing the request.
{
  "error": "Internal server error",
  "message": "An unexpected error occurred while fetching the event"
}

Notes

  • All prices are in USD
  • Event dates are returned in UTC timezone (ISO 8601 format)
  • This endpoint does not include seat availability or seatmap information
  • For complete seat details and availability, use GET /events//seatmap
  • The id parameter must be a valid UUID (GUID) format

Build docs developers (and LLMs) love