Skip to main content
GET
/
api
/
public
/
resources
/
published
/
summary

Resource Summary

Returns a lightweight summary of all published resources (desks, meeting rooms, offices, etc.) for the current location. Used for resource selectors and quick listings where full detail is not needed.

Authentication

No authentication required.

Query Parameters

_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation. Example: _shape=Name,ResourceTypeName,Id.

Response

Returns a ResourceSummaries object containing a lightweight summary of each published resource.

Resource Summary Fields

Identity

FieldTypeDescription
IdnumberUnique numeric identifier for the resource
UniqueIdstringGlobally unique identifier

Core

FieldTypeDescription
NamestringResource display name (localised)
DescriptionstringResource description (localised)
GroupNamestringResource group name
ResourceTypeNamestringResource type display name (localised)
VisiblebooleanWhether the resource is publicly visible
DisplayOrdernumberSort order in listings

Location

FieldTypeDescription
BusinessIdnumberLocation identifier
BusinessNamestringLocation display name
BusinessWebAddressstringLocation subdomain

Media

FieldTypeDescription
HasImagebooleanWhether the resource has an image

Timestamps (from base)

FieldTypeDescription
CreatedOnstringDate created (business-local time)
UpdatedOnstring | nullDate last updated (business-local time)
CreatedOnUtcstringDate created (UTC)
UpdatedOnUtcstring | nullDate last updated (UTC)

Examples

Fetch resource summaries

GET /api/public/resources/published/summary

TypeScript Integration

import endpoints from '@/api/endpoints'

const { resource: summaries } = useTypedData(httpClient, endpoints.resources.summary())