View all upcoming sessions API

Description: To fetch the list of all upcoming live sessions. The list will only include live workshops, and it will not include live lessons of courses.

Request URL: /api/v4/<orgId>/talks.json?filter=<Filter type>&limit=<Total course limit>&si=<Start index>
Learn how to get my <orgId>?

Method: GET
OAuth scope: TrainerCentral.talkapi.READ

Sample Request: https://zylkeracademy.trainercentral.com/api/v4/100000000/talks.json?filter=5&limit=100&si=0

Filter type:

Set filter type as 1 to list all your upcoming live sessions
Set filter type as 5 to list all upcoming live sessions of the academy (Admin role required)

By default, the list will only show 10 sessions, and if you want to show more sessions, you can increase the limit in the request URL as shown above.

Limit - Total sessions you want to list
Start index - This indicates where the list should start from, whether from 0 or from other position like 5.

Sample Response

{
  "sessions": [
    {
      "sessionIndex": "0",
      "timezone": "<timezone>",
      "description": "<sessionDescription>",
      "isPaidActiveTicketAvailable": "false",
      "orgId": "<orgId>",
      "formattedTotalRevenue": "Rs.0",
      "protoFlag": "1",
      "recurringType": "0",
      "descriptionId": "<descriptionId>",
      "deliveryMode": "3",
      "sessionType": "1",
      "createdTime": "1643622010125",
      "links": {
        "sessionMaterialSettings": "/api/v4/<orgId>/session/<sessionId>/sessionMaterialSettings.json",
        "tickets": "/api/v4/<orgId>/session/<sessionId>/tickets.json",
        "sessionMaterials": "/api/v4/<orgId>/session/<sessionId>/sessionMaterials.json",
        "presentationData": "/api/v4/<orgId>/session/<sessionId>/presentationData.json",
        "paymentPortals": "/api/v4/<orgId>/checkouts.json",
        "recentTalks": "/api/v4/<orgId>/session/<sessionId>/recentTalks.json",
        "sessionIntegration": "/api/v4/7385<orgId>81259/session/<sessionId>/sessionIntegration.json",
        "polls": "/api/v4/<orgId>/session/<sessionId>/polls.json",
        "evaluation": "/api/v4/<orgId>/session/<sessionId>/evaluation.json",
        "registrationSettings": "/api/v4/<orgId>/session/<sessionId>/registrationSettings.json",
        "mailTemplates": "/api/v4/<orgId>/session/<sessionId>/mailTemplates.json",
        "site": "/api/v4/<orgId>/session/<sessionId>/site.json",
        "tests": "/api/v4/<orgId>/session/<sessionId>/tests.json",
        "siteSettings": "/api/v4/<orgId>/session/<sessionId>/siteSettings.json",
        "certificates": "/api/v4/<orgId>/session/<sessionId>/certificates.json",
        "coupons": "/api/v4/<orgId>/coupons.json",
        "testAnalytics": "/api/v4/<orgId>/session/<sessionId>/testAnalytics.json",
        "assignmentSubmissions": "/api/v4/<orgId>/session/<sessionId>/assignmentSubmissions.json",
        "sessionSettings": "/api/v4/<orgId>/session/<sessionId>/sessionSettings.json",
        "presentersettings": "/api/v4/<orgId>/session/<sessionId>/presentersettings.json",
        "remainderTimings": "/api/v4/<orgId>/session/<sessionId>/remainderTimings.json"
      },
      "scheduledBy": "<userId>",
      "id": "<sessionId>",
      "totalRevenue": "0.0",
      "joinURL": "https://<domain>/session/<session unique key>",
      "deletedTime": "-1",
      "publishStatus": "0",
      "registeredCount": "0",
      "invitedCount": "0",
      "isFeaturedLesson": "false",
      "scheduledTime": "1643622300000",
      "kind": "0",
      "uniqueKey": "<session unique key>",
      "isRepublishNeeded": "false",
      "scheduledEndTime": "1643625900000",
      "sessionId": "<sessionId>",
      "attendedCount": "0",
      "referrer": "1",
      "sessionState": "0",
      "scheduleType": "0",
      "name": "<session name>",
      "zaid": "<zaid>",
      "time": "1643622010182"
    }
  ],
  "sessionMembers": [
    {
      "country": "<session member country>",
      "amount": "0.0",
      "role": "1", ADMIN = 0, SPEAKER = 1, ATTENDEE= 3, GUEST_PRESENTER =4
      "encryptedSessionMemberId": "<encryptedSessionMemberId>",
      "session": "<sessionId>",
      "sessionMemberId": "<sessionMemberId>",
      "language": "<language>",
      "emailId": "<userEmail>",
      "source": "<source>",
      "sessionId": "<sessionId>",
      "presenterImageUrl": "/api/v4/<orgId>/materials/image/<imageId>.json",
      "userId": "<userId>",
      "orgId": "<orgId>",
      "name": "<userName>",
      "createdTime": "1643622010135",
      "lastUpdatedTime": "1643622010135",
      "time": "1643622010135",
      "id": "<sessionmemberId>",
      "paymentStatus": "6",
      "status": "0"
    }
  ],
  "meta": {
    "totalSessionsCount": "<totalSessionsCount>"
  },
  "talks": [
    {
      "session": "<sessionId>",
      "orgId": "<orgId>",
      "formattedTotalRevenue": "Rs.0",
      "deliveryMode": "3",
      "sessionType": "1",
      "links": {
        "talkResources": "/api/v4/<orgId>/talk/<talkId>/talkResources.json",
        "pollQuestions": "/api/v4/<orgId>/talk/<talkId>/pollQuestions.json",
        "talkTimings": "/api/v4/<orgId>/talk/<talkId>/talkTimings.json",
        "questions": "/api/v4/<orgId>/talk/<talkId>/questions.json",
        "polls": "/api/v4/<orgId>/talk/<talkId>/polls.json",
        "accessRequests": "/api/v4/<orgId>/talk/<talkId>/accessRequests.json",
        "evaluation": "/api/v4/<orgId>/talk/<talkId>/forms.json?type=2",
        "registrationSettings": "/api/v4/<orgId>/talk/<talkId>/registrationSettings.json",
        "testAnalytics": "/api/v4/<orgId>/talk/<talkId>/testAnalytics.json",
        "audiences": "/api/v4/<orgId>/talk/<talkId>/audiences.json",
        "talkIntegration": "/api/v4/<orgId>/talk/<talkId>/talkIntegration.json",
        "likes": "/api/v4/<orgId>/talk/<talkId>/likes.json",
        "remainderTimings": "/api/v4/<orgId>/talk/<talkId>/remainderTimings.json",
        "breakoutSessions": "/api/v4/<orgId>/talk/<talkId>/breakouts.json",
        "talkPresentersDetails": "/api/v4/<orgId>/talk/<talkId>/talkPresentersDetails.json",
        "audienceRatings": "/api/v4/<orgId>/talk/<talkId>/audienceRatings.json",
        "talkMaterialSettings": "/api/v4/<orgId>/talk/<talkId>/talkMaterialSettings.json",
        "audienceProperties": "/api/v4/<orgId>/talk/<talkId>/audienceProperties.json",
        "presenterProperties": "/api/v4/<orgId>/talk/<talkId>/presenterProperties.json",
        "broadcastMessages": "/api/v4/<orgId>/talk/<talkId>/broadcastMessages.json",
        "site": "/api/v4/<orgId>/talk/<talkId>/site.json",
        "tests": "/api/v4/<orgId>/talk/<talkId>/forms.json?type=3",
        "talkProperties": "/api/v4/<orgId>/talk/<talkId>/talkProperties.json",
        "publishedTalk": "/api/v4/<orgId>/publishedTalk.json?talkId=<talkId>",
        "certificates": "/api/v4/<orgId>/talk/<talkId>/certificates.json",
        "recordings": "/api/v4/<orgId>/talk/<talkId>/recordings.json",
        "talkSettings": "/api/v4/<orgId>/talk/<talkId>/talkSettings.json",
        "chatGroups": "/api/v4/<orgId>/chatGroups.json?talkId=<talkId>",
        "chats": "/api/v4/<orgId>/chats.json?talkId=<talkId>",
        "questionvotes": "/api/v4/<orgId>/talk/<talkId>/questionvotes.json",
        "analytic": "/api/v4/<orgId>/talk/<talkId>/analytic.json"
      },
      "id": "<talkId>",
      "totalRevenue": "0.0",
      "talkId": "<talkId>",
      "joinURL": "https://<domain>/session/<session unique key>",
      "registeredCount": "0",
      "owner": "<userId>",
      "scheduledTime": "1643622300000",
      "scheduledEndTime": "1643625900000",
      "sessionId": "<sessionId>",
      "totalSlides": "0",
      "name": "<sessionName>",
      "audienceCount": "0",
      "status": "1"
    }
  ],
  "runningTalks": [
{
        "owner": "<userId>",
        "session": "<sessionId>",
        "latitude": "0.0",
        "sessionId": "<sessionId>",
        "projectorUid": "<projectorUid>",
        "runningId": "<runningId>",
        "talk": "<talkId>",
        "time": "1643624643105",
        "id": "<talkId>",
        "talkId": "<talkId>",
        "longitude": "0.0",
        "status": "2",
        "resourceType": "0"
    }
],
  "sessionCategories": [
{
  "moduleCategoryMappingId": "<moduleCategoryMappingId>",
  "moduleType": "2",
  "session": "<session>",
  "id": "<moduleCategoryMappingId>",
  "moduleId": "<moduleId>",
  "category": "<categoryId>",
  "categoryId": "<categoryId>"
}
]
}

Related Articles
List of all TrainerCentral APIs
Getting Started Get Oauth token API Course APIs Create chapter API Edit chapter API Create course API Edit course API Create lesson API Edit lesson API Create assignment API Delete lesson/live workshop/assignment API Delete chapter API Delete course ...
View all courses API
Description: To fetch the list of all courses in your academy. Request URL: /api/v4/<orgId>/courses.json?limit=<Number of courses fetched in this instance>&si=<Start index> (How to get my <orgId>?) Method: GET OAuth scope: ...
Get academy OrgID API
When you log in to TrainerCentral, you can see an ID (<orgId>) in the URL which will be a number. Example: https://trainercentral.com/#/portal/<orgID>/sessions/upcoming?sort=1 This <orgID> is used in the request URL of the APIs listed below. If you ...
Set up recurring sessions
TrainerCentral allows you to set up Recurring sessions with your attendees at regular intervals such as daily, weekly, or monthly for a specific period. This helps you save time and effort of manually creating the same session multiple times. Set up ...
View detailed analytics
Overview You can see even more information about how your attendee responded to your session, including likes, ratings, attendee questions, and poll answers, in Detailed Analytics. The detailed analytics start with the basics: The size of the ...

View all upcoming sessions API

View all upcoming sessions API

Related Articles

List of all TrainerCentral APIs

View all courses API

Get academy OrgID API

Set up recurring sessions

View detailed analytics