getSessionsByID
getSessionsByID API call retrieves detailed information for a specified session within the database. It accepts a session ID or IDs and retrieves detailed information about sessions associated with a specific program or event. It provides data on session timings, presenters, presentations, and additional session metadata.
Method: GET
Required Parameters
- Site Short Name
- Session ID(s) - up to 25
Optional Parameters
- _type
- External ID
Base URL
api.abstractcentral.com
Resource
/api/s1a/v3/abstracts/full/sessionsbyid
Request Parameters
Request Element with Example or Default Value
| Type | Description | Req |
|---|---|---|---|
sessionsbyid | Root | Yes | |
username
| String | "Profile” Username. | Yes |
Password
| String | The API Key | Yes |
site_name
| String | Site short name. The short name is the abbreviated or truncated name of the society, publisher, or family. | Yes |
ids
| Integer or | A distinct identifier assigned to each session within the ScholarOne Conferences system. | Yes |
url
| String | The Web Service URL, which identifies the specific service to handle the request. | Yes |
external_id
| String | An id value that can be set by the client for call tracking. API Caller supplied Text string to be stored with Audit History information. | No |
_type
| String | The data type requested from the Service | No |
Response Elements
Response elements with Example or Default Value
| Type | Description |
|---|---|---|
Status Can be one of SUCCESS, FAILURE, or MAINTENANCE.
| String | State of a given request call. |
callID
| String | The CALL_ID is the unique identifier for a given Web Services call. Generated by the ScholarOne Web Services application. |
profileCallId
| String | An id value that is set by the client for call tracking. Set by the request’s external_id element. |
programs Complex Child of Parent Root program | Complex | Defines the programs associated with the sessions. |
program Complex Child of programs dailyEndTime, dailyStartTime, endDate, name, programId, startDate, timeInterval | Complex | Contains data for an individual program. |
dailyEndTime Complex Child of program amPm, hour, minute | Complex | Specifies the conclusion of the daily schedule for the program. |
amPm
| String | Indicates program end time AM / PM. |
hour
| Integer | Program end time hour. |
minute
| Integer | Program end time minute. |
dailyStartTime Complex Child of program amPm, hour, minute | Complex | Specifies the start of the daily schedule for the program. |
amPm
| String | Indicates program start time AM / PM. |
hour
| Integer | Program start time hour. |
minute
| Integer | Program start time minute. |
endDate Complex Child of program day, dayName, month, year | Complex | Specifies the program's end date. |
day
| Integer | Day of the month. |
dayName
| String | Indicates the full name of the day corresponding to a specific date. |
month
| Integer | Indicates the program's end date, month in numerical format. |
year
| Integer | Program end date year. |
name
| String | The name of the program. |
programId
| Integer | A unique identifier for the program. |
startDate Complex Child of program day, dayName, month, year | Complex | Specifies the program's start date. |
day
| Integer | Day of the month. |
dayName
| String | Indicates the full name of the day corresponding to a specific date. |
month
| Integer | Indicates the program's start date, month, in numerical format. |
year
| Integer | Program start date year. |
timeInterval
| Integer | Configured program time interval in minutes. |
sessions Complex Child of Parent Root session | Complex | A collection of session details. |
session Complex Child of sessions
| Complex | Represents a single session within the program. |
csid
| Integer | Client session id (value assigned by sessioner). |
dateTimeModified
| dateTime | The timestamp indicating the last modification to the session. |
inIp
| Boolean | Flag to indicate whether to include the session in the IP. |
isInvited
| Boolean | Flag to indicate whether the session is invited. |
isTicketed
| Boolean | Flag to indicate whether the session is ticketed. |
itinLevelId
| Integer | Indicates internal system itinerary level Id. |
kind
| String | The type of session. |
levelName
| String | The name assigned to the level that the session is linked to (when using the level editor instead of the grid editor). |
parentItinLevelId
| Integer | Internal ID of the Parent level. |
presentations Complex Child of session presentation | Complex | Details about the presentations in a session. |
presentation Complex Child of presentations controlId, dateTimeModified, desc, duration, finalId, id, presentationEndTime, presentationStartTime, sessSort, status, title, type, withdrawnFromSession | Complex | Represents a single presentation within a session. |
controlId
| Integer | A unique identifier assigned to the specific abstract submission. |
dateTimeModified
| dateTime | The timestamp indicating the last modification date and time of this presentation record. |
desc | String | A placeholder for an optional descriptive text associated with the presentation. |
duration
| Integer | The duration of the presentation in minutes. |
finalId
| String | Final ID assigned to session abstract. |
id
| Integer | A unique identifier for the presentation instance. |
presentationEndTime Complex Child of presentation amPm, hour, minute | Complex | The scheduled end time of the presentation, defined in hours, minutes, and AM/PM format. |
amPm
| String | Specifies whether the time is AM or PM. |
hour
| Integer | The hour component of the end time. |
minute
| Integer | The minute component of the end time. |
presentationStartTime Complex Child of presentation amPm, hour, minute | Complex | The scheduled start time of the presentation, defined in hours, minutes, and AM/PM format. |
amPm
| String | Specifies whether the time is AM or PM. |
hour
| Integer | The hour component of the start time. |
minute
| Integer | The minute component of the start time. |
sessSort
| Integer | An integer value indicating the sort order of the presentation within a session. |
status
| String | The current abstract status. |
title
| String | The full title of the presentation. |
type
| String | The type of the presentation. |
withdrawnFromSession
| Boolean | A boolean value indicating whether the presentation has been withdrawn from the session. |
programId
| Integer | A unique identifier representing the specific program that the session is linked to. |
sessId
| Integer | A unique session identifier used to distinguish this session from others within the same program. |
sessionAbbr
| String | A shorthand code representing the session name or topic. Often includes abbreviations to provide a quick reference. |
sessionActualAttendance
| Integer | The recorded number of attendees present in the session. |
sessionCreator Complex Child of session email, fname, lname, memberId, mname, personId | Complex | This element encapsulates details about the individual responsible for creating a session. |
| String | The email address associated with the session creator. |
fname
| String | The first name of the session creator. |
lname
| String | The last name of the session creator. |
memberId
| String | A unique identifier for the session creator in the society's membership system. |
mname
| String | The middle name or middle initial of the session creator. |
personId
| Integer | A unique identifier for the author, used for internal tracking and reference. |
sessionDate Complex Child of session day, dayName, month, year | Complex | This element provides a structured representation of a specific session date. |
day
| Integer | Specifies the day of the month in numerical format. |
dayName
| String | Represents the name of the day in the week corresponding to the specified date. |
month
| Integer | Indicates the month of the year in numerical format. |
year
| Integer | Denotes the calendar year for the specified date. |
sessionDetails Complex Child of session sessionDetail | Complex | This element serves as a collection of multiple sessionDetail elements, each describing a specific attribute or property of the session. |
sessionDetail Complex Child of sessionDetails data, name | Complex | Represents a single detail or attribute of the session. |
data
| String | Holds the value or data corresponding to the session attribute specified by the name element. |
name | String | A human-readable label for the attribute being described. |
sessionDurationMinutes
| Integer | Specifies the total duration of the session in minutes. |
sessionEndTime Complex Child of session amPm, hour, minute | Complex | Contains details about the time at which the session ends. |
amPm
| String | Specifies whether the time is AM or PM. |
hour
| Integer | Represents the hour at which the session ends. |
minute
| Integer | Represents the minute of the hour when the session ends. |
sessionExpectedAttendance
| Integer | Indicates the number of participants anticipated for the session. |
sessionHosts Complex Child of session sessionHost | Complex | Container element that encapsulates details of all session hosts. |
sessionHost Complex Child of session address1, address2, city, country, degree, dept, email, fax, fname, inst, invitation, lname, memberId, mname, order, personId, phone, postalCode, ringgoldId, roleName, state, stateAbbrev | Complex | Represents an individual session host, including their personal details, role information, and invitation status. |
address1
| String | The primary address of the session host. |
address2
| String | An optional secondary address line, often used for apartment numbers or suite designations. |
city
| String | The city associated with the session host's location. |
country
| String | The country of residence for the session host. |
degre
| String | The academic or professional degree of the session host. |
dept
| String | The department or division associated with the session host's institution. |
| String | The email address of the session host. |
fax
| String | The fax number of the session host, if provided. |
fname
| String | The first name of the session host. |
inst
| String | The institution or organization with which the session host is affiliated. |
invitation Complex Child of sessionHost customMessage, dateAcceptanceDecline, dateInvitationClose, dateLastSent, declineReason, emailTemplateName, id, invitationStatus, lastSent, messageTemplateName, role | Complex | Contains details about the invitation sent to the session host. |
customMessage
| String | An optional custom message included with the invitation. |
dateAcceptanceDecline Complex Child of invitation day, dayName, month, year | Complex | Indicates the date on which the invitation was accepted or declined. |
day
| Integer | The day of the month when the invitation was accepted or declined. |
dayName
| String | The name of the day corresponding to the acceptance/decline date. |
month
| Integer | The month in numeric format when the invitation was accepted or declined. |
year
| Integer | The year when the invitation was accepted or declined. |
dateInvitationClose Complex Child of invitation amPm, day, dayName, hour, minute, month, year | Complex | Represents the closing date of the invitation. |
amPm
| String | Indicates whether the closing time is in AM or PM format. |
day
| Integer | Specifies the day of the closing date. |
dayName
| String | The name of the day corresponding to the closing date. |
hour
| Integer | Specifies the hour of the closing time. |
minute
| Integer | Specifies the minute of the closing time. |
month
| Integer | Specifies the month of the closing date. |
year
| Integer | Specifies the year of the closing date. |
dateLastSent Complex Child of invitation day, dayName, month, year | Complex | Indicates the most recent date on which the invitation was sent. |
day
| Integer | The day of the month when the invitation was last sent. |
dayName
| String | The name of the day corresponding to the last sent date. |
month
| Integer | The month in numeric format when the invitation was last sent. |
year
| Integer | The year when the invitation was last sent. |
declineReason
| String | Specifies the reason for declining the invitation, if provided. |
emailTemplateName
| String | The name of the email template used for sending the invitation. |
id
| Integer | A unique identifier for the invitation. |
invitationStatus
| String | Indicates the status of the invitation. |
lastSent
| String | The name of last sent email template sent. |
messageTemplateName
| String | The name of the template used for the invitation message. |
role
| String | The assigned role of the session host. |
lname
| String | The last name of the session host. |
memberId
| String | A unique identifier for the session host in the society's membership system. |
mname
| String | The middle name or middle initial of the session host. |
order
| Integer | A numeric value representing the sequence of the session host's role. |
personId
| Integer | A unique identifier for the session host, used for internal tracking and reference. |
phone
| String | The contact phone number of the session host. |
postalCode
| String | The postal or ZIP code of the session host’s address. |
ringgoldId
| Integer | An institutional or organizational identifier linked to the session host. |
roleName
| String | The specific role assigned to the session host in the context of the session. |
state
| String | The full name of the state in which the session host resides or is associated. |
stateAbbrev
| String | The standardized two-letter abbreviation of the state in which the session host resides or is associated. |
sessionLearningObj01
| String | Specifies the first learning objective of the session. |
sessionLearningObj02
| String | Outlines the second learning objective of the session. |
sessionLearningObj03
| String | Details the third learning objective of the session. |
sessionLocation Complex Child of session room, roomNotes, venue | Complex | Contains details about the session venue, including the specific room |
room
| String | Room where the session is scheduled. |
roomNotes
| String | Additional notes related to the room. |
venue
| String | Venue where the session is scheduled. |
sessionNeeds
| String | Placeholder for any specific needs or requirements for the session. |
sessionNotes
| String | Generic notes about the session. |
sessionNotesAdmin
| String | Reserved for administrative notes about the session. |
sessionProposalDateSubmitted Complex Child of session day, dayName, month, year | Complex | Indicates when the session proposal was submitted. |
day
| Integer | The day of the month when the session proposal was submitted. |
dayName
| String | The session proposal date, day of week. |
month
| Integer | Specifies the month when the session proposal was submitted. |
year
| Integer | Specifies the year when the session proposal was submitted. |
sessionStartTime Complex Child of session amPm, hour, minute | Complex | Specifies the session's start time. |
amPm
| String | Specifies whether the time is AM or PM. |
hour
| Integer | The hour component of the start time. |
minute
| Integer | The minute component of the start time. |
sessionStatus
| String | Indicates the session's administrative status. |
sessionTitle
| String | Provides the full title of the session. |
sessionTrack
| String | Categorizes the session within a specific track or theme. |
sessionTrackDescription
| String | A detailed description of the session track. |
sessionTrackOwners Complex Child of session sessionTrackOwner | Complex | The root container element that holds information about all owners assigned to a specific session track. |
sessionTrackOwner Complex Child of sessionTrackOwners email, fname, inst, lname, memberId, order, personId, roleName | Complex | Represents an individual assigned as an owner of the session track, including their personal and organizational details. |
| String | The email address of the session track owner. |
fname
| String | The first name of the session track owner. |
inst
| String | The name of the institution or organization associated with the session track owner. |
lname
| String | The last name of the session track owner. |
memberId
| String | A unique identifier for the session track owner in the society's membership system. |
order
| Integer | Specifies the sequence of the session track owner relative to other owners. |
personId
| Integer | A unique identifier for the session track owner, used for internal tracking and reference. |
roleName
| String | The role name of the session track owner. |
sessionType
| String | Specifies the type of session. |
showAbstractTimes
| Boolean | A Boolean field indicating whether abstract times should be displayed for the session. |
symposiaName
| String | Placeholder for the name of the symposia to which the session belongs. |
systemTags Complex Child of Parent Root systemTag | Complex | This is the root element that groups all system tags. |
systemTag Complex Child of systemTags tagName, tagValue | Complex | This element represents an individual tag in the system. |
tagName
| String | Specifies the name or identifier of the tag. |
tagValue
| String | Provides the value associated with the corresponding tagName. |
Updated 5 months ago
