cURL
curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/companies?limit=20&status=active' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"archivedAt": null,
"email": "hello@acme-nordic.example",
"id": 42,
"lastActivityAt": "2026-08-15T09:30:00.000Z",
"lifecycleStage": "PROSPECT",
"name": "Acme Nordic",
"organizationNumber": "12345678",
"phone": "+45 33 12 34 56",
"updatedAt": "2026-08-15T09:30:00.000Z",
"version": "v1.eyJpZCI6NDIsInJlc291cmNlIjoiY29tcGFueSIsInZlcnNpb24iOiIyMDI2LTA4LTE1VDA5OjMwOjAwLjAwMFoifQ",
"website": "https://acme-nordic.example"
}
],
"nextCursor": "eyJpZCI6NDIsInNvcnQiOiJ1cGRhdGVkLWRlc2MifQ"
}{
"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"
}
}Virksomheder
Hent virksomheder
Hent en cursor-pagineret virksomhedsliste i ét arbejdsområde.
GET
https://app.floral.so
/
api
/
v1
/
workspaces
/
{workspaceSlug}
/
companies
cURL
curl --request GET \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/companies?limit=20&status=active' \
--header 'Authorization: Bearer $FLORAL_TOKEN'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/companies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"archivedAt": null,
"email": "hello@acme-nordic.example",
"id": 42,
"lastActivityAt": "2026-08-15T09:30:00.000Z",
"lifecycleStage": "PROSPECT",
"name": "Acme Nordic",
"organizationNumber": "12345678",
"phone": "+45 33 12 34 56",
"updatedAt": "2026-08-15T09:30:00.000Z",
"version": "v1.eyJpZCI6NDIsInJlc291cmNlIjoiY29tcGFueSIsInZlcnNpb24iOiIyMDI2LTA4LTE1VDA5OjMwOjAwLjAwMFoifQ",
"website": "https://acme-nordic.example"
}
],
"nextCursor": "eyJpZCI6NDIsInNvcnQiOiJ1cGRhdGVkLWRlc2MifQ"
}{
"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.
Required string length:
1 - 128Sti-parametre
Slug for det arbejdsområde, adgangsoplysningen er bundet til.
Required string length:
1 - 100Pattern:
^[a-z0-9]+(?:-[a-z0-9]+)*$Forespørgselsparametre
Uigennemsigtig cursor returneret som nextCursor af den forrige side. Undersøg eller konstruér den ikke.
Maximum string length:
512Begræns resultater til ét trin i livscyklus.
Tilgængelige muligheder:
LEAD, PROSPECT, CUSTOMER, CHURNED Antal elementer, der skal returneres.
Nødvendigt interval:
1 <= x <= 50Stabil sortering af listen, som cursoren bruger.
Tilgængelige muligheder:
updated-desc, name-asc Livscyklustilstand, der skal medtages i listen.
Tilgængelige muligheder:
active, archived, all 