The Form Submission object
{
"id": "60c5e52b-e680-4b62-adc1-207e4ced130f",
"user": {
"id": "443f05ad-b1be-43bc-a213-3483471bc7fa",
"first_name": "Lara",
"last_name": "Smith",
"email": "[email protected]",
"gender": 0,
"address": "2934 Thurlow Road, Hampstead, Montreal, QC, Canada",
"phone_number": "929384838",
"date_of_birth": "1973-03-04",
"timezone": "America/Toronto",
"address_coordinates": [
"45.4787326",
"-73.6406602"
]
},
"submission_status": "New",
"created_at": "2024-10-30T21:19:53.069586Z",
"arrival_source": {
"id": "182e2f04-0d3c-4637-89a7-c6dbae95e90f",
"category": {
"id": "c82cd6c8-0b5a-48af-853d-0a57e6954969",
"title": "Title of Category A",
"description": "Description of Category A"
},
"title": "Opportunity Title A",
"description": "Description of Title A"
},
"questions": [
{
"id": "6d51d684-70a0-4d3e-a5ef-db61025e03de",
"question": {
"id": "d56d80ac-7665-49bd-b7f1-ddd6873377bd",
"title": "If applicable, describe your previously involvement here.",
"question_type": "Text",
"options": []
},
"answer": "",
"options": [],
"responded": false
},
{
"id": "24666398-306d-4058-a058-50364af12c06",
"question": {
"id": "3a25e1ab-fb49-49d1-ab6a-690e03e5a5cd",
"title": "Which days of the week would you like to join us?",
"question_type": "Checkbox",
"options": [
"Thursday",
"Tuesday/Thurs",
"Friday"
]
},
"answer": "",
"options": [
"Friday"
],
"responded": true
}
],
"medical_info": null,
"emergency_contact": {
"name": "Daniel",
"relationship": "Dad",
"phone_number": "9389393898"
},
"digital_consent": [
{
"id": "dc6a12a3-10da-49b7-bdf9-51514439f063",
"digital_consent_info": null,
"consent_status": 3 //Not provided
}
],
"general_availability": [
{
"id": "7b8cca42-fcfd-4566-9715-7a9ec57132bf",
"day": 2, //Tuesday
"availability": "Morning"
}
`` ],
"attachments": [
{
"id": "6c93e611-7e06-4aeb-9e30-fdad10126c2b",
"document_file": null,
"notes": "",
"attachment_info": {
"id": "854c5709-af07-49bd-b653-6a17154d192e",
"title": "Drivers License",
"description": ""
}
}
],
"opportunities": [
{
"opportunity": {
"id": "6dd9de34-eee5-48dc-a684-edef63f7cd61",
"category": {
"id": "c82cd6c8-0b5a-48af-853d-0a57e6954969",
"title": "Category Title A",
"description": "Description of Category Title A"
},
"title": "Opportunity Title A",
"description": "Description of Opportunity Title A"
},
"opportunity_shifts_count": 1
},
],
"folder": {
"name": "Basketball Program"
},
"form": {
"id": "b4078162-9d3c-41fa-abbb-aada180c87d5",
"title": "Form Title A"
}
},Components of the Submission Detail Objects
Each submission detail object provides comprehensive data related to a specific form submission by a user, which includes:
id (
string): A unique identifier for the form submission.user (
UserObject): Details of the user who made the submission.submission_status (
string): Status of the submission (e.g., New, Reviewed), including:New: Initial status for a form submission.
In Review: Submission is currently being reviewed.
Reviewed: Submission has been reviewed.
Rejected: Submission has been rejected.
Completed: Submission process is completed.
created_at (
string): Timestamp indicating when the form was submitted.arrival_source (
Arrival Source Array)questions (
Questions Array): A collection of questions and responses included in the submission.medical_info (
Medical Information Object): Basic medical information provided in the submission added by the user.emergency_contact (
Emergency Contact Object): Emergency contact details provided by the user.digital_consent (
Consent Array): Tracks digital consent provided by the user.general_availability (
Availability Array): General availability time slots, including days of the week coupled with the time of day (i.e. morning, afternoon, evening or a custom time slot provided by the user).attachments (
Attachments Array): Any files or documents attached to the submission as part of an attachments field.opportunity (
Opportunity Array): Opportunities relating to shifts that were associated with the submission, if any.folder (
Form Object): The folder related to the form which was submitted by the user.form (
Form Object): Information about the form that was submitted, including the ID and title.
Detailed Component Structures
User Object
Comprehensive details about the user's profile information.
id (
string): Unique identifier for the user.first_name, last_name, full_name (
string): The name of the user.email (
string): Email address of the user.gender (
string|null): The gender of the user.0= Male1= Female2= Other3= User inputted they would rather not sayaddress (
string): The complete address of the user.phone_number (
string): Phone number of the user.date_of_birth (
string|null): The date of birth of the user.address_coordinates (
array): Geographic coordinates of the user if an address was address via Google Maps. If the address was added via the import process, this data would not be available.
Arrival Source Array
In some circumstances, a user may be redirected to submit a form when trying to apply for an opportunity. When this occurs, we indicate the opportunity for which the user arrived from.
id (string): Identifier of the opportunity for which the user arrived from when submitting this form.
title (
string): Title of the opportunity.description (
string): description of the opportunity.category (category Object): Includes the categories related to the opportunity
id (
string): Identifier of the category.title (
string): Title of the category.
Questions Array
Each entry in this array represents a question and its respective answer:
id (
string): Identifier for the question within the form.question (
Question Object): Details of the question, including the title, type and options available.answer (string): The answer provided by the user (if the question type is not a single or multiple selection).
options (
array): The answer provided by the user (if the question type is a single or multiple selection field).responded (
boolean): Indicates whether the question was answered by the user.
Question Object
id (
sting): Identifier for the question, which can be used across multiple forms.title (
string): The text of the question.type (
integer): Represents the type of question, including:0: Text1: Single Selection2: Multiple Selection3: Date4: Timeslot5: Address6: Number7: Email8: Website9: Boolean
options (
array): Any selectable options associated with the question. Only applicable for single or multiple selection fields.
Medical Information Object
description (
string): Description of any medical information provided by the user.has_medical_info (
boolean): Indicates whether there is any medical information inputted for this user.
Emergency Contact Object
name (
string): The name of the emergency contact.phone_number (
string): The phone number of the emergency contact.relationship (
string): The relationship of the contact to the user.
Digital Consent Array
This array contains details about the digital consent provided by the user:
id (
string): Unique identifier for the consent entry.digital_consent_info (
integer): Includes the information created by the organization regarding the type of consent requested.consent_status (
integer): Indicates whether consent was provided or not.0: Typed1: Uploaded2: Not responded
Emergency Contact Object
name (
string): The name of the emergency contact.phone_number (
string): The phone number of the emergency contact.relationship (
string): The relationship of the contact to the user.
Availability Array
Outlines the general availability inputted by the user on this form:
id (
string): Identifier for the availability entry of the user's form.day (
integer): Day of the week represented numerically.0: Sunday1: Monday2: Tuesday3: Wednesday4: Thursday5: Friday6: Saturday
availability (
string): Description of the availability (e.g., Morning, Afternoon, Evening or Custom time slot).
Attachments Array
Details of documents attached to the form by the user:
id (
string): Unique identifier for the attachment on the form.document_file (
string): URL of the attached document by the userattachment_info (
Object): Details about the attachment requested by the admin including the ID, title and description shown to users.id (
string): Unique identifier for the attachment, which can be used across many forms.title (
string): title of the attachment field added by the organization.description (
Object): description of the attachment field added by the organization.
Opportunity Array
If a user submits the form and includes shifts on it, we provide a list of the opportunities related to the the shift along with the count of the number of shifts submitted for it.
id (
string): Identifier of the opportunity.title (
string): Title of the opportunity.description (
string): Description of the opportunity.opportunity_shifts_count (
string): Number of requested shifts included on the form submission for that opportunity.category (Category Object): Details of the related category to this opportunity
id (
string): Identifier of the category.title (
string): Title of the category.description (
string): Description of the category.
Folder Object
name (
string): Name of folder related to the form which was submitted by the user
Form Object
Details of the form submitted:
id (string): Unique identifier for the form which was submitted .
title (string): The title of the form which was submitted
Last updated