cURL
curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events/42' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events/{eventId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"event": {
"archivedAt": null,
"cancellationReason": null,
"cancelledAt": null,
"capacity": 80,
"createdAt": "2026-08-01T08:00:00.000Z",
"endsAt": "2026-09-24T17:00:00.000Z",
"finalisationState": "NOT_FINALISED",
"finalisedAt": null,
"format": "IN_PERSON",
"id": 42,
"joinReference": null,
"language": "da",
"location": "Nordhavn Warehouse, Copenhagen",
"organiserUserId": "user_01J5N9CF9QY8T4M2A7W3R6K1P0",
"ownerUserIds": [
"user_01J5N9CF9QY8T4M2A7W3R6K1P0"
],
"planningStatus": "READY",
"postponedAt": null,
"postponementReason": null,
"publicDescription": "An afternoon on hybrid workplace design.",
"publicSlug": "workplace-forum-2026",
"publicationState": "PUBLISHED",
"registrationClosesAt": "2026-09-22T22:00:00.000Z",
"registrationOpensAt": null,
"registrationState": "OPEN",
"startsAt": "2026-09-24T13:00:00.000Z",
"timezone": "Europe/Copenhagen",
"title": "Workplace Forum 2026",
"updatedAt": "2026-09-10T11:15:00.000Z",
"version": "v1.eyJpZCI6NDIsInJlc291cmNlIjoiZXZlbnQiLCJ2ZXJzaW9uIjoiMyJ9",
"waitlistEnabled": true
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "The request contains invalid values.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "A valid bearer credential is required.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "The credential does not grant this operation.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The resource was not found.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Too many requests. Retry shortly.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Events
Get an event
Get one event with its schedule, registration settings, planning and finalisation state. Internal planning notes are never returned.
GET
https://app.floral.so
/
api
/
v1
/
workspaces
/
{workspaceSlug}
/
events
/
{eventId}
cURL
curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events/42' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events/{eventId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"event": {
"archivedAt": null,
"cancellationReason": null,
"cancelledAt": null,
"capacity": 80,
"createdAt": "2026-08-01T08:00:00.000Z",
"endsAt": "2026-09-24T17:00:00.000Z",
"finalisationState": "NOT_FINALISED",
"finalisedAt": null,
"format": "IN_PERSON",
"id": 42,
"joinReference": null,
"language": "da",
"location": "Nordhavn Warehouse, Copenhagen",
"organiserUserId": "user_01J5N9CF9QY8T4M2A7W3R6K1P0",
"ownerUserIds": [
"user_01J5N9CF9QY8T4M2A7W3R6K1P0"
],
"planningStatus": "READY",
"postponedAt": null,
"postponementReason": null,
"publicDescription": "An afternoon on hybrid workplace design.",
"publicSlug": "workplace-forum-2026",
"publicationState": "PUBLISHED",
"registrationClosesAt": "2026-09-22T22:00:00.000Z",
"registrationOpensAt": null,
"registrationState": "OPEN",
"startsAt": "2026-09-24T13:00:00.000Z",
"timezone": "Europe/Copenhagen",
"title": "Workplace Forum 2026",
"updatedAt": "2026-09-10T11:15:00.000Z",
"version": "v1.eyJpZCI6NDIsInJlc291cmNlIjoiZXZlbnQiLCJ2ZXJzaW9uIjoiMyJ9",
"waitlistEnabled": true
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "The request contains invalid values.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "A valid bearer credential is required.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "The credential does not grant this operation.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The resource was not found.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Too many requests. Retry shortly.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Authorizations
Authenticate with a workspace-pinned Floral personal access token.
Headers
Optional caller-generated correlation ID. Floral returns the effective value in X-Request-ID.
Required string length:
1 - 128Path Parameters
Slug of the workspace pinned to the credential.
Required string length:
1 - 100Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Stable numeric event ID.
Required range:
x >= 1Response
Successful response
Show child attributes
Show child attributes
