REST API

Sample requests for the REST surface of the public API. Swap in your own TENANT_KEY / API_KEY.

Resolves a single page, including its resolved floor content. Supports floor-level pagination and geo/preview targeting.

Request

curl "https://api.contentveda.com/api/v1/pages/home" \
  -H "X-Tenant-Key: $TENANT_KEY" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Geo-Zone: GLOBAL" \
  -G \
  --data-urlencode "platform=desktop" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0" \
  --data-urlencode "country=IN" \
  --data-urlencode "tags=sale,featured"

Response

{
  "slug": "home",
  "title": "Home",
  "status": "PUBLISHED",
  "updatedAt": "2026-07-20T09:14:00Z",
  "content": [
    { "type": "banner", "id": "floor-1", "...": "..." },
    { "type": "grid-banner", "id": "floor-2", "...": "..." }
  ],
  "pagination": {
    "total": 6,
    "limit": 10,
    "offset": 0,
    "hasMore": false
  }
}

Pagination

Page lists use page / size (default size=20, max 100). Floor content within a single page uses limit / offset (max limit=50); the response always includes a pagination block so clients can tell how many floors/pages exist even when unpaginated.

Every request/response field is documented in Attribute Reference.