Get Recurring Workshop Series
Read a recurring series in the same terms Update Recurring Video Calls accepts, so it can be modified and sent straight back.
Returns recurringType, startDate, endDate, repeatingDays, fromTime and duration — the recurrence definition a replace accepts — plus every occurrence in occurrences (earliest first, including completed ones).
startDate–endDate is the replaceable range, not the whole series. A replace only rewrites occurrences that have not happened yet, so startDate is the first upcoming occurrence while endDate is the last occurrence overall. Completed occurrences fall before startDate; they stay untouched by a replace and are not described by this range. Read occurrences for the full history.
The recurrence rule is not stored, only its expansion, so recurringType and repeatingDays are inferred from the occurrences that exist: a series running every weekday reads back as daily, anything else as weekly.
isEditable reports whether a replace is still allowed; when false, notEditableReason says why. nextOccurrenceAt is the start of the next occurrence that has not begun, or null.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Path Parameters
ID of the recurring video-call group
Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Timezone offset in minutes.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/workshops/video-calls/groups/66c4964c11e7fef26751f3a6" \ -H "x-whitelabel-host: string" \ -H "x-timezone-offset: 330"{
"groupId": "66c4964c11e7fef26751f3a6",
"recurringType": "weekly",
"startDate": "2026-09-20",
"endDate": "2026-10-18",
"repeatingDays": [
0,
1,
1,
1,
1,
1,
0
],
"fromTime": "15:32",
"duration": 60,
"timezoneName": "Asia/Kolkata",
"upcomingCount": 6,
"completedCount": 2,
"nextOccurrenceAt": "2026-09-27T10:02:00.000Z",
"isEditable": true,
"notEditableReason": "This group has an occurrence starting within 30 minutes",
"occurrences": [
{
"_id": "66c4964c11e7fef26751f3a7",
"title": "Sunday Growth Workshop",
"description": "Plan the next growth campaign with practical examples.",
"thumbnail": "https://cdn.example.com/workshops/growth-workshop.jpg",
"fromTime": "2026-09-20T10:02:00.000Z",
"toTime": "2026-09-20T11:02:00.000Z",
"startDate": "2026-09-20",
"fromTime24h": "15:32",
"duration": 60,
"timezoneName": "Asia/Kolkata",
"timezone": "+05:30",
"status": "cancelled",
"isEditable": true,
"notEditableReason": "A call can only be edited up to 30 minutes before it starts",
"isScheduleLocked": false,
"platform": "tagmango",
"meetingUrl": "https://meet.google.com/abc-xyz",
"zoomMeetingType": "webinar",
"ongoingCallType": "webinar",
"zoomMeetingLink": "https://zoom.us/j/98765432101?pwd=abc123",
"zoomMeetingLinkCreator": "https://zoom.us/s/98765432101?zak=abc123",
"mango": [
{
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
}
],
"excludeMangoes": [
{
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
}
],
"mangoToSell": {
"_id": "66a1390268a76f2f5c9f39a3",
"title": "Introduction to Coding"
},
"zoomWaitingList": false,
"zoomRegistration": false,
"enableRecordingZoomCall": false,
"autoUploadRecordingsEnabled": false,
"autoUploadRecordingsConfig": [
{
"target": "course",
"courseId": "66c4964c11e7fef26751f3a9",
"courseTitle": "Advanced Marketing",
"sectionIds": [
"66c4964c11e7fef26751f3aa"
]
}
],
"recordings": [
{
"recordingType": "shared_screen_with_speaker_view",
"url": "https://cdn.example.com/recordings/abc.mp4",
"isZoomHostedUrl": false,
"recordingStartTime": "2026-09-20T10:02:00.000Z",
"recordingEndTime": "2026-09-20T11:02:00.000Z",
"fileSize": 148372221,
"fileExtension": "MP4"
}
],
"recordingReceivedAt": "2026-09-20T11:12:00.000Z",
"isRecordingDeleted": false,
"recordingDeletedAt": "2026-12-20T00:00:00.000Z",
"callType": "recurring",
"groupId": "66c4964c11e7fef26751f3a6",
"occurrence": 2,
"totalOccurrence": 8,
"showGroupLinkForRecurringCall": false,
"participantCount": 42,
"videoCallRescheduledAt": "2026-09-10T09:00:00.000Z",
"createdAt": "2026-09-01T09:00:00.000Z"
}
]
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 404,
"type": "Not Found",
"statusMessage": "NOT_FOUND",
"errorCode": "WORKSHOP_GROUP_NOT_FOUND",
"message": "No recurring group with this id belongs to this creator, or every occurrence in it has been deleted.",
"result": "No recurring group with this id belongs to this creator, or every occurrence in it has been deleted.",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}