DUMA/ API

Get a singleton

Returns a singleton content type’s one entry, such as a site’s footer or opening hours.

GEThttps://api.duma-business.com/v1/cms/delivery/singletons/{typeKey}

content:readPublishable or secret key

Responses carry a weak ETag; send it back as If-None-Match to get 304 Not Modified. Cache-Control: private, max-age=30, stale-while-revalidate=120.

A type that is not a singleton, or one that has not been published, is a 404.

Request example

Example request
curl -X GET "https://api.duma-business.com/v1/cms/delivery/singletons/{typeKey}" \
  -H "Authorization: Bearer dk_pub_…"

Path parameters

typeKeystringRequired
The singleton content type’s key.

Query parameters

localestring
A configured locale code. Defaults to the workspace’s default locale; an unknown code is a 400.
fallbackbooleanDefault true
When true, an entry missing in locale is served in its fallback language, then the default.
truefalse
fieldsstring
Comma-separated field keys to return, e.g. title,hero. Unknown or private fields are a 400.
includenumberDefault 1
How many levels of media and reference fields to resolve into objects (0–3). Anything unresolvable stays as { id }.
statusstringDefault published
draft reads drafts — only a secret key with content:preview.
publisheddraft

Response

Response · 200
{
  "data": {
    "id": "2b4d6f8a-0c1e-4a3b-9d5f-7e9a1c3b5d7f",
    "type": "opening-hours",
    "locale": "en",
    "slug": null,
    "createdAt": "2026-09-04T08:00:00.000Z",
    "updatedAt": "2026-10-25T17:20:00.000Z",
    "publishedAt": "2026-10-25T17:21:00.000Z",
    "firstPublishedAt": "2026-09-04T08:10:00.000Z",
    "fields": {
      "weekdays": "7:30am – 5pm",
      "weekends": "8:30am – 4pm",
      "note": "Closed on Boxing Day"
    }
  }
}