Schema Reference

A field-by-field reference for the programme feed, in plain English. This page covers the same information as /data/schema/v1.json — use that file to generate types or validate locally; use this page to read.

Draft. This reference (and the underlying schema) covers the shape confirmed against the real chi2023–chi2026 and sandbox feeds, but is not yet a complete or formally validated schema — some collections below are marked "not yet typed in detail." See Programme Data for the update-polling pattern and licence.

← Back to Programme Data

Top-level fields

Field	Type	Required	What it is
`schemeVersion`	integer	Yes	Native export format version from the conference system. Currently `7`. Not a per-edition content revision — see `version.json` for that.
`cc_licence`	string	No	Human-readable licence statement embedded in the feed itself. See /data/LICENCE for the full text.
`conference`	object	Yes	Conference metadata. See field detail below.
`publicationInfo`	object	No	Publication/draft status. See field detail below.
`rooms`	array of objects	No	Venue rooms. See field detail below.
`tracks`	array of objects	No	Thematic/format groupings. See field detail below.
`sessions`	array of objects	Yes	Scheduled paper sessions. See field detail below.
`events`	array of objects	No	Standalone scheduled events. See field detail below.
`contents`	array of objects	Yes	Papers, talks, and other contributions. See field detail below.
`people`	array of objects	Yes	Authors, presenters, and chairs. See field detail below.
`recognitions`	array	No	Awards/recognitions attached to contents. Not yet typed in detail.
`sponsors`, `sponsorLevels`,`floors`, `contentTypes`,`timeSlots`	array	No	Present in the feed but not yet typed in detail.

Times are epoch milliseconds. IDs are integers, stable within an edition — the same session's ID is the same in the historical file, in the live feed, and after it gets moved.

`conference`

Conference metadata. A single object, not an array.

Field	Type	Required	Notes
`id`	integer	Yes	—
`shortName`	string	No	e.g. "CHI"
`year`	integer	Yes	—
`startDate`	integer	Yes	Epoch milliseconds
`endDate`	integer	Yes	Epoch milliseconds
`fullName`	string	No	e.g. "The ACM CHI conference on Human Factors in Computing Systems"
`url`	string (URI)	No	—
`location`	string	No	e.g. "Pittsburgh, PA"
`timeZoneOffset`	integer	No	Minutes offset from UTC
`timeZoneName`	string	No	e.g. "America/New_York"
`name`	string	Yes	e.g. "CHI 2027"

`publicationInfo`

Publication/draft status maintained by the conference system. A single object, not an array.

Field	Type	Notes
`isDraft`	boolean	—
`isProgramEnabled`	boolean	—
`publicationDate`	string	—
`publicationStatus`	string	e.g. "PUBLISHED"
`version`	integer	The closest analogue to a content "revision" inside the file itself — not a top-level `revision` field (that lives in `version.json`, see Checking for updates).

`rooms`

Array of venue room objects.

Field	Type	Required	Notes
`id`	integer	Yes	—
`name`	string	Yes	—
`setup`	string or null	No	—
`typeId`	integer or null	No	—
`capacity`	integer or null	No	—

`tracks`

Array of thematic/format grouping objects.

Field	Type	Required
`id`	integer	Yes
`name`	string	Yes

`sessions`

Array of scheduled paper session objects — room, time slot, chairs, and the contents within.

Field	Type	Required	Notes
`id`	integer	Yes	—
`name`	string	Yes	—
`isParallelPresentation`	boolean	No	—
`typeId`	integer or null	No	—
`roomId`	integer or null	No	References `rooms[].id`. Null if no room assigned yet.
`chairIds`	array of integers	No	References `people[].id`.
`contentIds`	array of integers	No	References `contents[].id`.
`timeSlotId`	integer or null	No	—

`events`

Array of standalone scheduled event objects (receptions, plenaries) distinct from paper sessions — these carry their own start/end times rather than a time slot reference.

Field	Type	Required	Notes
`id`	integer	Yes	—
`name`	string	Yes	—
`roomId`	integer or null	No	References `rooms[].id`.
`startDate`	integer	Yes	Epoch milliseconds
`endDate`	integer	Yes	Epoch milliseconds
`presenterIds`	array of integers	No	References `people[].id`.

`contents`

Array of individual paper/talk contribution objects — title, abstract, authors, tags/keywords, and links back to the session(s)/event(s) that contain them.

Field	Type	Required	Notes
`id`	integer	Yes	—
`typeId`	integer or null	No	—
`title`	string	Yes	—
`isBreak`	boolean	No	—
`trackId`	integer or null	No	References `tracks[].id`.
`tags`	array of strings	No	—
`keywords`	array of strings	No	—
`sessionIds`	array of integers	No	References `sessions[].id`.
`eventIds`	array of integers	No	References `events[].id`.
`abstract`	string or null	No	—
`authors`	array	No	Not yet typed in detail.
`recognitionIds`	array of integers	No	References `recognitions[].id`.

`people`

Array of author/presenter/chair objects.

Field	Type	Required	Notes
`id`	integer	Yes	—
`firstName`	string or null	No	—
`lastName`	string or null	No	—
`middleInitial`	string or null	No	—
`affiliations`	array	No	Not yet typed in detail.

Top-level shape (abbreviated JSON)

{
  "schemeVersion": 7,
  "cc_licence": "…",
  "conference": { "id": …, "year": 2027, "startDate": …, "name": "CHI 2027", … },
  "publicationInfo": { "isDraft": false, "version": 224, … },
  "rooms":     [ … ],
  "tracks":    [ … ],
  "sessions":  [ … ],
  "events":    [ … ],
  "contents":  [ … ],
  "people":    [ … ]
}

Machine-readable schema (JSON Schema)·← Back to Programme Data