Getting started
Make your first authenticated call to the Billy API Platform.
Prerequisites
Before you begin, make sure you have:
- A Billy account with platform access
- A valid API key (available on demand)
- A tool to make HTTP requests (curl, Postman, or an HTTP client in your preferred language)
Your First Request
The Billy API is accessible at the following base URL:
https://platform.billyapp.live/To make your first API call, you can list your events:
curl -X GET "https://platform.billyapp.live/v1/events" \
-H "Authorization: Bearer billy:o:your-org-id:your-api-key"If everything works correctly, you will receive a JSON response containing your events list:
{
"items": [
{
"id": "evt_64f1c2a9e8b4a12f9c0a1234",
"title": "Jazz Concert",
"description": "An exceptional jazz evening",
"venueName": "Salle Pleyel",
"currency": "EUR",
"sessionCount": 1,
"firstSessionStartAt": "2025-03-21T19:30:00.000Z",
"lastSessionStartAt": "2025-03-21T19:30:00.000Z",
"nextSessionStartAt": "2025-03-21T19:30:00.000Z",
"nextSessionId": "68799a92-c357-454d-afa5-54ed51f1f98f"
}
],
"page": 1,
"perPage": 100,
"totalPages": 1
}Sessions moved out of the event payload
From release 2026-09-01 an Event carries only the summary fields shown above.
Enumerate its sessions with GET /v1/events/{event_id}/sessions.
Before that date — or pinned to an earlier version with the Billy-API-Version
header — the Event still embeds an eventSessions array instead. See
Versioning.
Next steps
Requests are authenticated with a Bearer key, paginated, and filterable. Read Authentication and Pagination next, then try the endpoints in the API reference.