curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events?limit=20&planningStatus=READY&sort=starts-asc' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"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
}
],
"nextCursor": "eyJ2IjoxLCJzdGFydHNBdCI6IjIwMjYtMDktMjQifQ"
}{
"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"
}
}List events
List a cursor-paginated event collection ordered by start time, with planning, finalisation, owner, archive, and local-date filters.
curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events?limit=20&planningStatus=READY&sort=starts-asc' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"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
}
],
"nextCursor": "eyJ2IjoxLCJzdGFydHNBdCI6IjIwMjYtMDktMjQifQ"
}{
"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.
1 - 128Path Parameters
Slug of the workspace pinned to the credential.
1 - 100^[a-z0-9]+(?:-[a-z0-9]+)*$Query Parameters
Whether archived events are excluded, included, or the only ones returned.
exclude, include, only Opaque cursor returned as nextCursor by the previous page. Pass it back with the same filters; do not inspect or construct it.
512Restrict results to one attendance finalisation state.
NOT_FINALISED, FINALISED Inclusive local date. Matches events whose local dates, in the event's own timezone, end on or after this date. Undated events never match a date range.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Number of items to return.
1 <= x <= 50Restrict results to events owned by one workspace member.
1 - 255Restrict results to one planning status.
IDEA, PLANNING, READY, HELD, FOLLOW_UP, EVALUATED, CANCELLED Order by start time, undated events last, then by ID. The cursor is bound to the sort.
starts-asc, starts-desc Inclusive local date. Matches events whose local dates start on or before this date.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$