Session Handouts

MethodEndpointDescription
POST/v5/oauth/tokenGenerate an OAuth access token
GET/v5/forms/attendeeFieldsRetrieve attendee form fields
POST/v5/users/attendeesCreate or update an attendee
GET/v5/users/attendeesRetrieve all attendees
POST/v5/users/attendees/{attendeeId}/resumeUpload an attendee's resume
DELETE/v5/users/attendees/{attendeeId}/deleteRemove an attendee
POST/v5/sessions/sessionTracksCreate or update a session track
GET/v5/sessions/sessionTracksRetrieve all session tracks
DELETE/v5/sessions/sessionTracks/{id}Delete a session track
POST/v5/sessionsCreate or update a session
GET/v5/sessionsRetrieve all sessions
DELETE/v5/sessions/{id}Delete a session
POST/v5/sessions/sessionHandoutsUpload or update a session handout
GET/v5/sessions/sessionHandoutsRetrieve all session handouts
DELETE/v5/sessions/sessionHandouts/{id}Remove a session handout
GET/v5/forms/speakerFieldsRetrieve speaker form fields
POST/v5/users/speakersCreate or update a speaker profile
GET/v5/users/speakersRetrieve all speakers
DELETE/v5/users/speakersRemove a speaker profile
GET/v5/event/languagesRetrieve available event languages
GET/v5/event/getEventDetailsGet detailed event information
GET/v5/reports/qrScanAnalyticsRetrieve QR scan analytics
GET/v5/reports/userJourneyAnalyticsRetrieve user journey analytics
Download OpenAPI description
Download Postman
Download OpenApi
Overview
Integrations integrations@vfairs.com
Languages
Servers
US
https://api.vfairs.com/rest/
CA
https://api.vfairs.ca/rest/
EU
https://api-eu.vfairs.com/rest/
UK
https://api-uk.vfairs.com/rest/
KSA
https://api-ksa.vfairs.com/rest/

OAuth Access Token

This section provides endpoints to authenticate vFairs event. It covers how to get an access token, manage its lifecycle, and handle event-specific access. vFairs uses OAuth 2.0 to ensure secure and controlled API access, allowing applications to authenticate safely without exposing sensitive credentials.

Operations

Attendees

This section provides endpoints to manage event attendees, including registration field retrieval, attendee creation, updates, bulk/group registrations, resume uploads, and user deletions. Secure access requires event-specific OAuth tokens. The API supports dynamic form configurations, pagination, filtering by email or user_id, and nested child_users for structured group registrations.

Operations

Session Tracks

This section provides endpoints to create, update, retrieve, and delete session tracks for multi-language events. Use track_id=0 for new tracks. Tracks require language-specific mapping via /v5/event/languages. Supports pagination, filtering, and bulk retrieval to efficiently manage localized session tracks.

Operations

Sessions

This section provides endpoints to create, update, retrieve, and delete event sessions. Use session_id=0 for new entries. Sessions can be linked to session tracks and speakers via their IDs and require language-specific entries via /v5/event/languages for multi-language support. The API supports pagination, filtering, and bulk data retrieval for efficient session management.

Operations

Session Handouts

This section provides endpoints to create, update, retrieve, and delete session handouts. Use session_handout_id=0 for new entries. Handouts are linked to sessions via their IDs, which can be retrieved from /v5/sessions. The API supports pagination, filtering, bulk retrieval, and document management to ensure seamless attendee access.

Operations

Create/Update Session Handout

Request

This endpoint is used to create or update session handout information for the session. When creating a new session handout, the session_handout_id value is 0 or null. Session Handouts are documents associated to the session, available for the attendees to view or read.

To associate sessions with the relevant session handouts for listing purposes, use the Get Sessions endpoint to retrieve Session IDs and assign the relevant Session ID to the session handout.

Bodyapplication/jsonrequired
handout_idinteger

The id of the handout, required while updating the record.

Example: 0
session_idintegerrequired

The id of the session.

Example: 2171860
handout_linkstringrequired

The handout file to be uploaded. Accepted file formats: PDF and DOCX.

Example: "path/to/file/resume.pdf"
handout_titlestringrequired

The title of the handout.

Example: "Handout Title"
curl -i -X POST \
  https://api.vfairs.com/rest/v5/sessions/sessionHandouts \
  -H 'Authorization: Bearer <YOUR_bearer_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "handout_id": 0,
    "session_id": 2171860,
    "handout_link": "path/to/file/resume.pdf",
    "handout_title": "Handout Title"
  }'

Responses

Bodyapplication/json
statusboolean
Example: true
messagestring
Example: "Session Handout(s) created successfully."
handout_idinteger
Example: 12345
Response
application/json
{
  "status": true,
  "message": "Session Handout(s) created successfully.",
  "handout_id": 12345
}

Get Session Handouts

Request

This endpoint is used to fetch a collection of session handouts from the event. You can customize the returned data by specifying query parameters, as the data will be fetched based on these parameters. To navigate through the entire collection, use the pagination fields included in the response.

Need details about a single session handouts?

You can also get detailed information for an individual session handouts by specifying its unique session_id in the query parameters.

Query
pageinteger

The page number for pagination.

Example: page=1
limitinteger

The number of records to return per page.

Example: limit=12
session_idinteger

Filter by session ID.

Example: session_id=2178341
handout_idinteger

Filter by handout ID.

Example: handout_id=17806
curl -i -X GET \
  'https://api.vfairs.com/rest/v5/sessions/sessionHandouts?handout_id=17806&limit=12&page=1&session_id=2178341' \
  -H 'Authorization: Bearer <YOUR_bearer_HERE>'

Responses

Bodyapplication/json
statusboolean
Example: true
messagestring
Example: "Successful retrieval of session handouts."
session_handoutsArray of objects
Example: [{"session_id":579720,"handouts":[{"handout_id":15322,"handout_title":"See and Secure Every Device and Connection in the Industrial Environments","handout_link":"https://vfairs-core-backend-prod.s3.amazonaws.com/8995/sessions/RS51AXTdG1OBOnMaCnALzAOiSTcPMtVrVTatk05m.pdf"}]}]
Response
application/json
{
  "status": true,
  "message": "Successful retrieval of session handouts.",
  "session_handouts": [
    { … }
  ]
}

Delete Session Handout

Request

This endpoint is used to delete a session handout from the session.

Path
idstringrequired

The ID of the sessionHandout.

Example: autem
sessionHandoutIdintegerrequired

The unique identifier of the session handout to be deleted.

Example: 17806
curl -i -X DELETE \
  https://api.vfairs.com/rest/v5/sessions/sessionHandouts/autem \
  -H 'Authorization: Bearer <YOUR_bearer_HERE>'

Responses

Bodyapplication/json
statusboolean
Example: true
messagestring
Example: "Session Handout deleted successfully."
handout_idinteger
Example: 17806
Response
application/json
{
  "status": true,
  "message": "Session Handout deleted successfully.",
  "handout_id": 17806
}

Speakers

This section provides endpoints to create, update, retrieve, and delete speaker profiles. Use speaker_id=0 for new entries. Speakers can be linked to sessions via their IDs, retrieved from /v5/sessions. The API supports dynamic form configurations, including fields like company_name and bio, and allows image handling, session associations, and deletions by speaker_id, email, or session_id.

Operations

Event

This section provides endpoints to retrieve event metadata, including available languages for multi-language configuration and detailed event information. These endpoints are essential for localizing content such as sessions and tracks and integrating event-specific settings to ensure a seamless and customized event experience.

Operations

Reports

This section provides endpoints to retrieve reports of the events

Operations
Copyright © 2025 vFairs