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": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"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": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Autorisationer
Godkend med en personlig Floral-adgangsnøgle, der er bundet til ét arbejdsområde.
Overskrifter
Valgfrit korrelations-id fra kalderen. Floral returnerer den anvendte værdi i X-Request-ID.
1 - 128Sti-parametre
Slug for det arbejdsområde, adgangsoplysningen er bundet til.
1 - 100^[a-z0-9]+(?:-[a-z0-9]+)*$Forespørgselsparametre
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])))$Antal elementer, der skal returneres.
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 Sortér efter starttidspunkt med arrangementer uden dato sidst og derefter efter ID. Markøren er bundet til sorteringen.
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])))$