BillyDocumentation

Retrieve an event

Retrieves a single event by its identifier. Use GET /v1/events/{event_id}/sessions to enumerate the event sessions. Returns 404 when the event does not exist or does not belong to your organization.

GET
/v1/events/{event_id}

Retrieves a single event by its identifier. Use GET /v1/events/{event_id}/sessions to enumerate the event sessions. Returns 404 when the event does not exist or does not belong to your organization.

Authorization

HTTPBearer
AuthorizationBearer <token>

API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Path Parameters

event_id*Event Id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/events/string"
{  "id": "evt_64f1c2a9e8b4a12f9c0a1234",  "createdAt": "2025-01-15T10:42:31.000Z",  "updatedAt": "2025-01-20T09:12:05.000Z",  "title": "Electro Night Festival",  "description": "An immersive electronic music experience with top international DJs.",  "imageUrl": "https://cdn.example.com/events/electro-night/banner.jpg",  "venueName": "La Grande Halle",  "venueAddress": {    "addressLine1": "211 Avenue Jean Jaurès",    "addressLine2": null,    "city": "Paris",    "postalCode": "75019",    "countryCode": "FR"  },  "eventTimezone": "Europe/Paris",  "currency": "EUR",  "sessionCount": 1,  "firstSessionStartAt": "2025-03-21T19:30:00+01:00",  "lastSessionStartAt": "2025-03-21T19:30:00+01:00",  "nextSessionStartAt": null,  "nextSessionId": null,  "tags": [    "concert",    "electro"  ]}