Session JSON

Support Center > API Integration

Published 01/06/2015 at 7:28pm UTC

Page viewed 3692 times

Details

How do I interpret the JSON for a Session?

Answer

Here is an example of Session JSON returned by the Session APIs:

[
{
"SessionId": 9636,
"ScheduleTs": "2014-04-16T15:00:00",
"BillableTs": null,
"ConnectCode": 981342223,
"DurationMinutes": null,
"BillableStatusCd": null,
"UserId": 2942,
"IsRecorded": false,
"Participants": [
{
"ParticipationId": 18619,
"ParticipantFullName": "A. MacGuffin",
"SecureVideoUserId": 12,
"ParticipantEmailAddress": "real@mccoy.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 701678455,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
},
{
"ParticipationId": 18620,
"ParticipantFullName": "Trevor",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "trevor@geemail.com",
"ParticipantSmsNumber": "4041113333",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 378174671,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
}
]
},
{
"SessionId": 9641,
"ScheduleTs": "2014-04-16T22:00:00",
"BillableTs": null,
"DurationMinutes": null,
"BillableStatusCd": null,
"UserId": 2942,
"Participants": [
{
"ParticipationId": 18628,
"ParticipantFullName": "A. MacGuffin",
"SecureVideoUserId": 12,
"ParticipantEmailAddress": "real@mccoy.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 318789499,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
},
{
"ParticipationId": 18629,
"ParticipantFullName": "Ray Chalk",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "rc@anotheremail.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 317682700,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
},
{
"ParticipationId": 18630,
"ParticipantFullName": "Sidney Gondor",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 317951015,
"ShouldAutoDeliverCode": "N",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
}
]
},
{
"SessionId": 9718,
"ScheduleTs": "2014-04-17T20:30:00",
"BillableTs": null,
"DurationMinutes": null,
"BillableStatusCd": null,
"UserId": 2942,
"Participants": [
{
"ParticipationId": 18783,
"ParticipantFullName": "A. MacGuffin",
"SecureVideoUserId": 12,
"ParticipantEmailAddress": "real@mccoy.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 221284396,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
},
{
"ParticipationId": 18784,
"ParticipantFullName": "Ray Chalk",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "rc@anotheremail.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 347409115,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": 1037,
"DepositRequired": 20.00
},
{
"ParticipationId": 18785,
"ParticipantFullName": "John Llama",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "jllama13579@aol.com",
"ParticipantSmsNumber": "",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 472712120,
"ShouldAutoDeliverCode": "E",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Unknown",
"SvcId": null,
"DepositRequired": null
},
{
"ParticipationId": 18786,
"ParticipantFullName": "Trevor",
"SecureVideoUserId": null,
"ParticipantEmailAddress": "trevor@geemail.com",
"ParticipantSmsNumber": "4041113333",
"ParticipantDefaultResolution": "high",
"ParticipantTimeZoneWindowsId": "Eastern Standard Time",
"ConnectCode": 849481506,
"ShouldAutoDeliverCode": "S",
"ConnectionTs": null,
"ExpiresTs": null,
"RSVP": "Confirmed",
"SvcId": null,
"DepositRequired": null
}
]
} ]

In the Session JSON:

  • SessionId is the unique identifier for the Session
  • ScheduleTs is the date and time that the Session is scheduled for, in UTC.  For "Meet Now" Sessions, the ScheduleTs will be the time that the session was created, and will have a random minutes and seconds component, e.g., 2014-04-16T15:11:22.  For Scheduled Sessions, the ScheduleTs will have 0 seconds, and the minute will be 0, 15, 30, or 45, e.g. 2014-04-16T15:00:00.
  • BillableTs is the time at which the Session becomes a "real" session, in UTC.  While this is called "BillableTs", it does not mean the session will be charged to your company--the session may be later comped by us, or it may count in your included monthly sessions.  A non-null BillableTs means that the session was connected by two people, and is eligible for examination by our billing system to see whether it should be billed.  Once BillableTs is set, it is never changed.  If BillableTs is not set (for a future meeting, or a past one which was never connected to), then null is returned.
  • DurationMinutes is the number of minutes the host was connected to any participant in the session. For sessions which have not yet been deactivated, this number may increase if the session is reconnected later. DurationMinutes will be null if the host is still connected to one or more session participants, or if session end time is unknown. If the end time is known for at least one participant-call, then DurationMinutes will be an integer, the number of minutes that the session host was connected to at least one participant-call whose end time is known. Note that one participant may have multiple participant-calls, for example if the participant left the session and then rejoined. DurationMinutes will be available for most sessions which first connected on or after May 28, 2015, however due to technical causes, we expect to be unable to capture the duration for a small percentage of sessions in a given month--the peer-to-peer nature of SecureVideo can make it very difficult to capture the end time of a call given certain combinations of network conditions and events.
  • BillableStatusCd is the current billing state of the session.  If BillableTs is null, then BillableStatusCd will be null also.  If BillableTs is not null, then BillableTs will be one of four possible values:
    • BILL - The session counts towards the number of free sessions in a month, and will be charged to your account if beyond that limit
    • SVCO - The session is with SecureVideo.com Support, and does not count towards your monthly session limit
    • DUPL - The session has been flagged by our system as a likely Duplicate, and does not count towards your monthly session limit.  It most likely represents a second attempt to conduct an online session between the same two parties at around the same time.
    • COMP - The session has been comped by our Support team, and does not count towards your monthly session limit
  • UserId is the identifier of the user who hosted the Session.  This UserId can be looked up using the User API.
  • IsRecorded specifies whether the session will be automatically recorded to the SecureVideo cloud. Note that, if true, the session will be recorded when it initiates, however the session host can still stop, pause, and resume recording once the session is in progress.
  • The array of Participants will always have at least two Participants, the first of which will be the Session host, followed by one or more Session participants in an indeterminate order.  Within each Participant object exist the following properties:
    • ParticipationId - Uniquely identifies the participant's participation in the Session.  This ID is used if you want to remove a participant from a session via the API.
    • ParticipantFullName - The full name of the participant
    • SecureVideoUserId - If the participant is a SecureVideo user, the user ID of the user. If the participant is not a SecureVideo user, this will be null.
    • ParticipantEmailAddress - The e-mail address of the participant.  This can be an empty string when the session host chooses not to Auto-Deliver the connect code to the participant.
    • ParticipantSmsNumber - The mobile phone number of the participant, for sending an SMS message.  This will be an empty string when the session host chooses not to Auto-Deliver the connect code to the participant.
    • ParticipantDefaultResolution - The resolution the participant should start at.  Possible values are 'high', 'default', and 'low'.  We recommend using 'high' under most network and device conditions.
    • TimeZoneWindowsId is the Windows ID of the time zone, and must be a value from this list of valid time zones. Time Zone is required by our system's core scheduling functionality, to ensure an invitation shows the correct time for a given participant.
    • ConnectCode - The 9 digit code used by the participant to join or RSVP to the session.  This should only ever be shown to the participant.
    • ShouldAutoDeliverCode - string, possible values are:
      • "E": If ParticipantEmailAddress exists, the SecureVideo system will send via e-mail a Session invite and Session reminders to this participant.
      • "S": If ParticipantSmsNumber exists, the SecureVideo system will send via text message a Session invite and Session reminders to this participant.
      • "N": No automatic delivery of the code will occur.  The Session host, or your system, will be responsible for providing invites and reminders to the Participant.
    • ConnectionTs - the time, in UTC, of the first connection attempt made by the participant.  For the host's participant object (the first object in the Participants array), this will be the time the host first attempted to connect to any other participant in the session.  For a non-host participant object (the second and subsequent objects in the Participants array), this will be the time the participant first attempted to enter the Waiting Room to wait for the Host to connect to them.  Please note, an attempt to connect will fill in this value, whether or not the connection attempt was successful.
    • ExpiresTs - If ExpiresTs is not null, the expiration date of the meeting pass.
    • RSVP - the RSVP status can be either Unknown, Confirmed, or Declined.  Because it is not possible for Session hosts to RSVP, the RSVP property for Session hosts will always be Unknown.
    • SvcId and DepositRequired - If you have set up Stripe payments in the UI (Features > Get Paid Online), you can specify a deposit that this participant must pay the DepositRequired amount (in US dollars) by credit card prior to entering the waiting room to receive a specified Service referenced by the SvcId that you would find as the Service ID on your "Account Services" screen. If you specify null for both SvcId and DepositRequired (the default), then the participant will be able to enter the waiting room without making a payment. SvcId and DepositRequired must both either be null, or both be not null.

 

 

This article was last reviewed by our Support team on April 19, 2017.