List summaries

List a cursor-paginated meeting-summary feed with status, company, appointment-time, and evidence-audience filters.

GET https://app.floral.so/api/v1/workspaces/{workspaceSlug}/summaries

cURL

cURL

curl --request GET \
  --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/summaries?evidenceAudience=CUSTOMER&limit=20&status=WAITING_APPROVAL' \
  --header 'Authorization: Bearer $FLORAL_TOKEN'

200

{
  "items": [
    {
      "appointmentDate": "2026-08-18T09:00:00.000Z",
      "company": {
        "id": 42,
        "name": "Acme Nordic"
      },
      "createdAt": "2026-08-15T10:00:00.000Z",
      "durationSec": 2700,
      "evidenceAudience": "CUSTOMER",
      "excerpt": "The team agreed on the next launch milestones.",
      "id": 168,
      "name": "Quarterly planning",
      "status": "WAITING_APPROVAL",
      "updatedAt": "2026-08-15T10:30:00.000Z",
      "version": "v1.eyJpZCI6MTY4LCJyZXNvdXJjZSI6InN1bW1hcnkiLCJ2ZXJzaW9uIjoiMjAyNi0wOC0xNVQxMDozMDowMC4wMDBaIn0"
    }
  ],
  "nextCursor": null
}

Authorizations

Authorization · string · header · required

Authenticate with a workspace-pinned Floral personal access token.

Headers

X-Request-ID · string

Optional caller-generated correlation ID. Floral returns the effective value in X-Request-ID.

Required string length: 1 - 128

Path Parameters

workspaceSlug · string · required

Slug of the workspace pinned to the credential.

Required string length: 1 - 100

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Query Parameters

cursor · string

Opaque cursor returned as nextCursor by the previous page. Do not inspect or construct it.

Maximum string length: 512

limit · integer · default: 20

Number of items to return.

Required range: 1 <= x <= 50

appointmentAfter · string<date-time>

Include summaries whose effective appointment time is at or after this timestamp.

appointmentBefore · string<date-time>

Include summaries whose effective appointment time is at or before this timestamp.

companyId · integer

Restrict results to one company ID.

Required range: x >= 1

evidenceAudience · enum<string>

Restrict to customer evidence (CUSTOMER) or Floral-internal meetings (INTERNAL).

Available options: CUSTOMER, INTERNAL

status · enum<string>

Restrict results to one summary status.

Available options: WAITING, WAITING_APPROVAL, APPROVED, FAILED

Response

200

application/json

Successful response

items · object[] · required

Maximum array length: 50

Show child attributes

nextCursor · string | null · required

Required string length: 1 - 512