Submission JSON Endpoint - Schema Reference

{
    /**
     * Self-describing envelope for the feed
     */
    _meta: Meta;
    /**
     * High level details for the event
     */
    event: EventDetails;
    /**
     * The whole submission form: its sections, questions and options.
     * Present even for questions that have no answers.
     */
    form: Form;
    /**
     * The submissions (responses) to the form
     */
    responses: Response[];
    /**
     * The title of the Call for Papers
     */
    title: string;
    /**
     * The UUID of the Call for Papers
     */
    id: string;
}

{
    /**
     * The schema version. Incremented on breaking changes. Currently 1.
     */
    schemaVersion: number;
    /**
     * When this feed was generated, ISO 8601 UTC.
     * Changes only when the data is (re)published, not on every request.
     * eg 2026-02-04T18:03:03.662Z
     */
    generatedAt: string;
    /**
     * A human/agent-readable description of the feed
     */
    description: string;
    /**
     * The URL of this schema reference's parent documentation
     */
    documentationUrl: string;
}

{
    /**
     * The UUID of the event
     */
    id: string;
    /**
     * The name of the event
     */
    name: string;
    /**
     * The timezone for the event.
     * Potentially null for awards only events.
     * Note that all times in this document are UTC.
     */
    timezone: string | null;
    /**
     * The dates for the event
     */
    dates: EventDate[];
    /**
     * If the event has a portal, the public url submitters use to access
     * their content. Null otherwise.
     */
    portalURL: string | null;
}

{
    /**
     * The start of an event day in UTC, ISO 8601
     * eg 2022-02-04T18:05:00.000Z
     */
    startDate: string | null;
    /**
     * The start of an event day in the event timezone, YYYY-MM-DD
     */
    localStartYYYYMMDD: string | null;
    /**
     * The start of an event day in the event timezone, HH:MM
     */
    localStartHHMM: string | null;
    /**
     * The end of an event day in UTC, ISO 8601
     */
    endDate: string | null;
    /**
     * The end of an event day in the event timezone, YYYY-MM-DD
     */
    localEndYYYYMMDD: string | null;
    /**
     * The end of an event day in the event timezone, HH:MM
     */
    localEndHHMM: string | null;
}

{
    /**
     * The sections of the form, in position order. Each section owns its
     * 'main' / 'profile' questions.
     */
    sections: FormSection[];
    /**
     * The Review Stages, in position order. Each stage owns the evaluation
     * questions reviewers answer in that stage. An evaluation's `scores` and
     * `answers` resolve their question id against the questions nested here.
     */
    evaluationPhases: EvaluationPhase[];
    /**
     * The Submission Stages, in position order. Each records which 'main' /
     * 'profile' questions are editable / locked / hidden in that stage. A
     * Submission's `phase` (and each `phaseHistory` entry) resolves here.
     */
    responsePhases: ResponsePhase[];
}

{
    /**
     * The UUID of the section
     */
    id: string;
    /**
     * The name of the section. Null if unnamed.
     */
    name: string | null;
    /**
     * The position of the section within the form, for ordering
     */
    position: number;
    /**
     * Which part of the form this section belongs to:
     * - 'profile'    questions about the people submitting
     * - 'main'       questions about the submission itself (the session/proposal)
     * Evaluation questions are not grouped into sections — they appear under
     * their Review Stage in the top-level `evaluationPhases` array, not here.
     */
    group: 'main' | 'profile';
    /**
     * The questions in this section, in form order
     */
    questions: FormQuestion[];
}

{
    /**
     * The UUID of the question
     */
    id: string;
    /**
     * The label (text) of the question. Null if unset.
     */
    label: string | null;
    /**
     * The question type, eg 'text', 'textarea', 'number', 'checkbox', 'radio',
     * 'dimension', 'table', 'email', 'phone', 'url', 'ugc-upload', 'image'.
     */
    type: string;
    /**
     * Which part of the form this question belongs to:
     * - 'profile'    a question about the people submitting
     * - 'main'       a question about the submission itself
     * - 'evaluation' a question answered by a reviewer (nested under a Review
     *                Stage in form.evaluationPhases, with a null sectionId)
     */
    group: 'main' | 'profile' | 'evaluation';
    /**
     * The question's model-link intent, eg 'firstName', 'title', 'score'.
     * Open set — tolerate unknown values. Null if the question is not model-linked.
     * See the Intent reference below.
     */
    intent: string | null;
    /**
     * The position of the question within the form, for ordering
     */
    position: number;
    /**
     * The UUID of the section this question belongs to. Null for evaluation
     * questions, which are grouped under a Review Stage instead
     * (see form.evaluationPhases).
     */
    sectionId: string | null;
    /**
     * The options for choice questions (checkbox, radio, dimension). Absent for
     * question types that have no options.
     */
    options?: QuestionOption[];
}

{
    /**
     * The UUID of the option. Stable; pairs with the option id on answers.
     */
    id: string;
    /**
     * The label of the option. Null if unset.
     */
    label: string | null;
    /**
     * The option's model-link intent. Closed set.
     */
    intent: 'RECOMMENDATION_YES' | 'RECOMMENDATION_NO' | 'RECOMMENDATION_MAYBE' | null;
}

{
    /**
     * The UUID of the Review Stage
     */
    id: string;
    /**
     * The name of the Review Stage
     */
    name: string;
    /**
     * The position of the Review Stage, for ordering
     */
    position: number;
    /**
     * The evaluation questions answered in this stage, in form order
     */
    questions: FormQuestion[];
}

{
    /**
     * The UUID of the Submission Stage
     */
    id: string;
    /**
     * The name of the Submission Stage
     */
    name: string;
    /**
     * The position of the Submission Stage, for ordering
     */
    position: number;
    /**
     * Which questions are editable / locked / hidden in this stage. Each entry
     * references a question by `{ id, name }` (name being the question label),
     * in form order.
     *
     * Only populated for Content Portal events. On other events all three lists
     * are empty — per-stage question visibility is not tracked there.
     */
    questionVisibility: {
        editable: QuestionReference[];
        locked: QuestionReference[];
        hidden: QuestionReference[];
    };
}

{
    id: string;
    /**
     * The question label. Null if unset.
     */
    name: string | null;
}

{
    /**
     * The UUID of the Submission
     */
    id: string;
    /**
     * The display title of the Submission
     */
    title: string;
    /**
     * The current Submission Stage. Its id resolves against form.responsePhases.
     */
    phase: { id: string; name: string };
    /**
     * The ordered history of Submission Stage transitions, earliest first.
     */
    phaseHistory: PhaseHistoryEntry[];
    /**
     * The Submitter
     */
    respondent: User;
    /**
     * The Speakers on this Submission. A profile is a Speaker (contributor);
     * a Submission may carry several.
     */
    profiles: Profile[];
    /**
     * When the Submission was created, ISO 8601 UTC. Null if unknown.
     */
    createdDate: string | null;
    /**
     * The answers to the 'main' (session / proposal) questions
     */
    sessionAnswers: Answer[];
    /**
     * The Reviews of this Submission
     */
    evaluations: Evaluation[];
    /**
     * If the Submission has been linked to an agenda session, its details.
     * Absent otherwise.
     */
    session?: Session;
}

{
    /**
     * The UUID of the user
     */
    id: string;
    /**
     * The display name of the user
     */
    name: string;
    /**
     * The user's email.
     * Absent when the publication has contact details turned off.
     */
    email?: string;
}

{
    /**
     * The Submission Stage transitioned to.
     * id is null if the stage has since been deleted; name is retained.
     */
    phase: { name: string | null; id: string | null };
    /**
     * Who initiated the transition
     */
    initiator: 'RESPONDENT' | 'TEAM';
    /**
     * When the transition happened, ISO 8601 UTC
     */
    timestamp: string;
}

{
    /**
     * The UUID of the profile
     */
    id: string;
    /**
     * The answers to the 'profile' questions for this speaker
     */
    answers: Answer[];
    /**
     * If this profile is linked to an agenda contributor, its UUID. Null otherwise.
     */
    contributorId: string | null;
}

{
    /**
     * The UUID of the agenda session
     */
    id: string;
    /**
     * The name of the agenda session
     */
    name: string;
}

{
    /**
     * The UUID of the Review
     */
    id: string;
    /**
     * The state of the Review, eg 'PENDING', 'COMPLETED'
     */
    state: string;
    /**
     * The per-question scores the Reviewer gave. Null if none recorded.
     */
    scores: EvaluationScore[] | null;
    /**
     * The Reviewer's summary. Null if unset.
     */
    summary: string | null;
    /**
     * When the Review was assigned, ISO 8601 UTC. Null if unset.
     */
    assignedDate: string | null;
    /**
     * When the Review is due, ISO 8601 UTC. Null if unset.
     */
    dueDate: string | null;
    /**
     * The Reviewer
     */
    evaluator: User;
    /**
     * The answers to the Review questions
     */
    answers: Answer[];
    /**
     * The Review Stage the Review belongs to. Always present;
     * its id resolves against form.evaluationPhases.
     */
    phase: { id: string; name: string };
}

{
    /**
     * The UUID of the question this score is for. Resolves against the form.
     */
    questionId: string;
    /**
     * The numeric score
     */
    score: number;
}

{
    /**
     * The UUID of the answer
     */
    id: string;
    /**
     * The UUID of the question. Resolves against the form.
     */
    questionId: string;
    /**
     * The label of the question. Null if unset.
     */
    question: string | null;
    /**
     * The question's model-link intent (see Intent reference).
     * Open set. Absent if the question is not model-linked.
     */
    intent?: string;
}

| {
      type: 'number';
      /**
       * The numeric value. Null if empty or not a number.
       */
      value: number | null;
  }
| {
      type: 'option' | 'text' | 'textarea' | 'url' | 'email' | 'phone';
      /**
       * The text value. Null if unanswered.
       *
       * For 'email' and 'phone', `value` is also `null` when the publication
       * (or report) has contact details turned off — the answer is still
       * present, but the contact detail is redacted.
       */
      value: string | null;
  }
| {
      type: 'table';
      /**
       * The parsed table data. Any JSON value (object, array, string, number,
       * boolean or null).
       */
      value: JSONValue;
  }

type JSONValue =
    | string
    | number
    | boolean
    | null
    | JSONValue[]
    | { [key: string]: JSONValue };

{
    type: 'checkbox' | 'radio';
    options: OptionSelection[];
}

{
    /**
     * The UUID of the option. Resolves against the form.
     */
    id: string;
    /**
     * The label of the option. Null if unset.
     */
    label: string | null;
    /**
     * The option's model-link intent. Closed set.
     */
    intent: 'RECOMMENDATION_YES' | 'RECOMMENDATION_NO' | 'RECOMMENDATION_MAYBE' | null;
    /**
     * Whether this option is selected.
     */
    selected: boolean;
}

{
    type: 'dimension';
    /**
     * Human-readable summary of the answer, eg 'Knowledge: 5, Relevance: 3'.
     */
    value: string;
    /**
     * Per-option values. One entry per visible option, in display order.
     */
    options: {
        /**
         * The UUID of the option. Resolves against the form.
         */
        id: string;
        /**
         * The option's label. Null if unset.
         */
        label: string | null;
        intent: 'RECOMMENDATION_YES' | 'RECOMMENDATION_NO' | 'RECOMMENDATION_MAYBE' | null;
        /**
         * The value for this option. Number for numeric dimensions, string for
         * text dimensions, or null when unset.
         */
        value: string | number | null;
    }[];
}

{
    type: 'shoutout';
    /**
     * The video links once processed. Null until the video is ready.
     */
    value: null | { sharableLink: string; downloadLink: string };
}

{
    type: 'ugc-upload' | 'image';
    files: File[];
}

{
    /**
     * The UUID of the file
     */
    id: string;
    /**
     * The name of the file
     */
    fileName: string;
    /**
     * The File Type of the file (see below)
     */
    type: FileType;
    /**
     * The size of the file in bytes
     */
    size: number;
    /**
     * The mime type of the file, eg 'image/png'
     */
    mimeType: string;
    /**
     * The URL to retrieve the file. Unique to this publication; revoked when
     * the publication is deleted.
     */
    url: string;
    /**
     * For image answers, the scaled variants of the image. Empty for files.
     */
    variants: FileVariant[];
}

| {
      /**
       * A custom File Type created for this event
       */
      isPredefined: false;
      /**
       * The name of the File Type, eg 'Slides'
       */
      name: string;
      /**
       * The UUID of the custom File Type
       */
      id: string;
  }
| {
      /**
       * A predefined File Type
       */
      isPredefined: true;
      /**
       * The name of the predefined type, eg 'Speaker Profile Image'
       */
      name: string;
      /**
       * The predefined type id. Additional types may be added over time.
       */
      id:
          | 'generic'
          | 'contributorHeadshot'
          | 'contributorLogo'
          | 'locationLogo'
          | 'locationSponsorLogo'
          | 'sessionHandouts'
          | 'sessionSlides'
          | 'sessionSponsorLogo'
          | 'trackLogo';
  }

File & {
    /**
     * The size the image was scaled to fit within
     * THUMB  = 128x128
     * SMALL  = 256x256
     * MEDIUM = 512x512
     * LARGE  = 1024x1024
     * FULL   = the same resolution as the originally uploaded image
     */
    scale: 'THUMB' | 'SMALL' | 'MEDIUM' | 'LARGE' | 'FULL';
}