Teachers
Teachers · 8 operations
GETList teachers
/api/teacherGETGet teacher/api/teacher/{id}GETGet teacher qualifications/api/teacher/{id}/qualificationsGETGet teacher work schedule/api/teacher/{id}/work-scheduleGETFind free teachers for a time slot/api/teacher/work-schedule/availableGETTeachers working on a day/api/teacher/work-schedule/dayPOSTCreate teacher/api/teacherPATCHUpdate teacher/api/teacher/{id}GET
List teachers
/api/teacherTeachers with filters (search, subjects, status, qualification) and pagination.
list_teachers
Query parameters · 25
pagemin 1 · default 1pageSize1–250 · default 20sortByOne of: status name emails phones messengers linkssortOrderOne of: ASC DESCteacherIds—search—firstName—lastName—Show 17 more
middleName—genderOne of: MALE FEMALEnote—typesOfMessengerChannels where the teacher has a connected chat; several values are OR-ed.One of: TELEGRAM_BOT INSTAGRAM FACEBOOK IMESSAGEsubjectIds—statusOfTeacherId—statusOfTeacherIds—teacherReportStatusIds—qualificationSubjectIds—qualificationIds—teacherLevelIds—classOfStudentIds—teachingProgramIds—typeOfLessonIds—isBirthdayToday—isArchivaldefault falsecf—Response · 200
application/json
statusCodeexample 200message—data4 fields
total—totalPages—currentPage—teachers16 fields
teacherId—firstName—lastName—middleName—contacts3 fields
type—value—label—dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEnote—avatarUrl—isArchival—updatedAtformat YYYY-MM-DDTHH:mm:sscreatedAtformat YYYY-MM-DDTHH:mm:ssworkload2 fields
scheduledHours—workHours—status3 fields
statusOfTeacherId—nameOfStatus—showInWorkCalendar—chatsConnected chats; the table row shows their channel icons.4 fields
chatParticipantId—chatId—createdAtformat YYYY-MM-DDTHH:mm:sschatAlways present at runtime; optional because card selects are built dynamically
and TS cannot prove the nested object exists.5 fields
chatId—contactName—avatar—lastMessageAtformat YYYY-MM-DDTHH:mm:ssmessenger4 fields
messengerId—nameOfMessenger—typeOfMessengerOne of: TELEGRAM_BOT INSTAGRAM FACEBOOK IMESSAGEcapabilitiesWhat the channel supports; null when its adapter is not registered, so the chat is read-only.customFieldsCustom field values for the columns selected in the table preset.any keyscurl "https://your-school.rist.pro/api/teacher" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": {
"total": 0,
"totalPages": 0,
"currentPage": 0,
"teachers": [
{
"teacherId": 1,
"firstName": "string",
"lastName": "string",
"middleName": "string",
"contacts": [
{
"type": "string",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"note": "string",
"avatarUrl": "string",
"isArchival": false,
"updatedAt": "2026-11-09T14:30:00",
"createdAt": "2026-11-09T14:30:00",
"workload": {
"scheduledHours": 0,
"workHours": 0
},
"status": {
"statusOfTeacherId": 1,
"nameOfStatus": "string",
"showInWorkCalendar": false
},
"chats": [
{
"chatParticipantId": 1,
"chatId": 1,
"createdAt": "2026-11-09T14:30:00",
"chat": {
"chatId": 1,
"contactName": "string",
"avatar": "string",
"lastMessageAt": "2026-11-09T14:30:00",
"messenger": {
"messengerId": 1,
"nameOfMessenger": "string",
"typeOfMessenger": "TELEGRAM_BOT",
"capabilities": {}
}
}
}
],
"customFields": {}
}
]
}
}GET
Get teacher
/api/teacher/{id}One teacher card with contacts, subjects and custom fields.
get_teacher
Path parameters · 1
id—Response · 200
application/json
statusCodeexample 200message—data19 fields
teacherId—firstName—lastName—middleName—contacts3 fields
type—value—label—dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEnote—payoutMethodPayout details; returned only with the payoutDetails field permission.One of: CARD IBAN CASHpayoutRecipient—payoutDetails—payoutNote—payoutAccount2 fields
accountId—nameOfAccount—avatarUrl—isArchival—updatedAtformat YYYY-MM-DDTHH:mm:sscreatedAtformat YYYY-MM-DDTHH:mm:sschats4 fields
chatParticipantId—chatId—createdAtformat YYYY-MM-DDTHH:mm:sschatAlways present at runtime; optional because card selects are built dynamically
and TS cannot prove the nested object exists.5 fields
chatId—contactName—avatar—lastMessageAtformat YYYY-MM-DDTHH:mm:ssmessenger4 fields
messengerId—nameOfMessenger—typeOfMessengerOne of: TELEGRAM_BOT INSTAGRAM FACEBOOK IMESSAGEcapabilitiesWhat the channel supports; null when its adapter is not registered, so the chat is read-only.customFieldsany keyscurl "https://your-school.rist.pro/api/teacher/1" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher/1", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher/1",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": {
"teacherId": 1,
"firstName": "string",
"lastName": "string",
"middleName": "string",
"contacts": [
{
"type": "string",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccount": {
"accountId": 1,
"nameOfAccount": "string"
},
"avatarUrl": "string",
"isArchival": false,
"updatedAt": "2026-11-09T14:30:00",
"createdAt": "2026-11-09T14:30:00",
"chats": [
{
"chatParticipantId": 1,
"chatId": 1,
"createdAt": "2026-11-09T14:30:00",
"chat": {
"chatId": 1,
"contactName": "string",
"avatar": "string",
"lastMessageAt": "2026-11-09T14:30:00",
"messenger": {
"messengerId": 1,
"nameOfMessenger": "string",
"typeOfMessenger": "TELEGRAM_BOT",
"capabilities": {}
}
}
}
],
"customFields": {}
}
}GET
Get teacher qualifications
/api/teacher/{id}/qualificationsQualifications of one teacher.
get_teacher_qualifications
Path parameters · 1
id—Response · 200
application/json
curl "https://your-school.rist.pro/api/teacher/1/qualifications" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher/1/qualifications", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher/1/qualifications",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": …
}GET
Get teacher work schedule
/api/teacher/{id}/work-scheduleWorking hours of one teacher by weekday (when the teacher is available for lessons).
get_teacher_work_schedule
Path parameters · 1
id—Response · 200
application/json
curl "https://your-school.rist.pro/api/teacher/1/work-schedule" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher/1/work-schedule", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher/1/work-schedule",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": {}
}GET
Find free teachers for a time slot
/api/teacher/work-schedule/availableTeachers whose work schedule covers the slot (dateTimeStart/dateTimeEnd, school local time) and who have no lesson then; cancelled lessons do not count. Optional subjectIds and typeOfLessonIds keep only qualified teachers.
find_available_teachers
Query parameters · 4
dateTimeStartSlot start, school local time (YYYY-MM-DDTHH:mm).dateTimeEndSlot end, school local time.subjectIdsOnly teachers qualified for these subjects.typeOfLessonIdsOnly teachers qualified for these lesson types.Response · 200
application/json
curl "https://your-school.rist.pro/api/teacher/work-schedule/available?dateTimeStart=string&dateTimeEnd=string" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher/work-schedule/available?dateTimeStart=string&dateTimeEnd=string", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher/work-schedule/available",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
params={
"dateTimeStart": "string",
"dateTimeEnd": "string"
},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": [
{}
]
}GET
Teachers working on a day
/api/teacher/work-schedule/dayTeachers with working hours on a school day (date, YYYY-MM-DD): their hours and how many lessons (not cancelled) they have that day.
list_teachers_working_on_day
Query parameters · 2
dateSchool-local calendar day, YYYY-MM-DD.subjectIdsOnly teachers qualified for these subjects.Response · 200
application/json
curl "https://your-school.rist.pro/api/teacher/work-schedule/day?date=string" \
-H "Authorization: Bearer $RIST_API_KEY"const response = await fetch("https://your-school.rist.pro/api/teacher/work-schedule/day?date=string", {
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
},
});
const { data } = await response.json();import os
import requests
response = requests.get(
"https://your-school.rist.pro/api/teacher/work-schedule/day",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
params={
"date": "string"
},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": [
{}
]
}POST
Create teacher
/api/teacherCreate a teacher card. Look the teacher up with GET /api/teacher first to avoid duplicates.
create_teacher
Request body
application/json · object
firstNamelength 1–30lastNamelength max 30middleNamelength max 30subjectIdsmin 1contacts3 fields
typeOne of: PHONE EMAIL MESSENGER URLvaluelength 1–255labellength max 50dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEmeetingLinkIdmin 1statusOfTeacherIdmin 1teacherReportStatusIdmin 1notelength max 1500payoutMethodOne of: CARD IBAN CASHpayoutRecipientlength max 150payoutDetailslength max 100payoutNotelength max 500payoutAccountIdSchool account the salary is paid from.min 1customFieldsany keysResponse · 201
application/json
statusCodeexample 201message—data16 fields
teacherId—firstName—lastName—middleName—contacts3 fields
type—value—label—dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEnote—avatarUrl—isArchival—updatedAtformat YYYY-MM-DDTHH:mm:sscreatedAtformat YYYY-MM-DDTHH:mm:ssworkload2 fields
scheduledHours—workHours—status3 fields
statusOfTeacherId—nameOfStatus—showInWorkCalendar—chatsConnected chats; the table row shows their channel icons.4 fields
chatParticipantId—chatId—createdAtformat YYYY-MM-DDTHH:mm:sschatAlways present at runtime; optional because card selects are built dynamically
and TS cannot prove the nested object exists.5 fields
chatId—contactName—avatar—lastMessageAtformat YYYY-MM-DDTHH:mm:ssmessenger4 fields
messengerId—nameOfMessenger—typeOfMessengerOne of: TELEGRAM_BOT INSTAGRAM FACEBOOK IMESSAGEcapabilitiesWhat the channel supports; null when its adapter is not registered, so the chat is read-only.customFieldsCustom field values for the columns selected in the table preset.any keyscurl -X POST "https://your-school.rist.pro/api/teacher" \
-H "Authorization: Bearer $RIST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
}'const response = await fetch("https://your-school.rist.pro/api/teacher", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
}),
});
const { data } = await response.json();import os
import requests
response = requests.post(
"https://your-school.rist.pro/api/teacher",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
json={
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
},
)
response.raise_for_status()
data = response.json()["data"]Response example · 201
{
"statusCode": 201,
"message": "Operation completed successfully",
"data": {
"teacherId": 1,
"firstName": "string",
"lastName": "string",
"middleName": "string",
"contacts": [
{
"type": "string",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"note": "string",
"avatarUrl": "string",
"isArchival": false,
"updatedAt": "2026-11-09T14:30:00",
"createdAt": "2026-11-09T14:30:00",
"workload": {
"scheduledHours": 0,
"workHours": 0
},
"status": {
"statusOfTeacherId": 1,
"nameOfStatus": "string",
"showInWorkCalendar": false
},
"chats": [
{
"chatParticipantId": 1,
"chatId": 1,
"createdAt": "2026-11-09T14:30:00",
"chat": {
"chatId": 1,
"contactName": "string",
"avatar": "string",
"lastMessageAt": "2026-11-09T14:30:00",
"messenger": {
"messengerId": 1,
"nameOfMessenger": "string",
"typeOfMessenger": "TELEGRAM_BOT",
"capabilities": {}
}
}
}
],
"customFields": {}
}
}PATCH
Update teacher
/api/teacher/{id}Change fields of a teacher card. Send only the fields to change: contacts and subjectIds, when sent, replace the whole list.
update_teacher
Path parameters · 1
id—Request body
application/json · object
firstNamelength 1–30lastNamelength max 30middleNamelength max 30subjectIdsmin 1contacts3 fields
typeOne of: PHONE EMAIL MESSENGER URLvaluelength 1–255labellength max 50dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEmeetingLinkIdmin 1statusOfTeacherIdmin 1teacherReportStatusIdmin 1notelength max 1500payoutMethodOne of: CARD IBAN CASHpayoutRecipientlength max 150payoutDetailslength max 100payoutNotelength max 500payoutAccountIdSchool account the salary is paid from.min 1customFieldsany keysResponse · 200
application/json
statusCodeexample 200message—data16 fields
teacherId—firstName—lastName—middleName—contacts3 fields
type—value—label—dateOfBirthformat YYYY-MM-DDTHH:mm:ssgenderOne of: MALE FEMALEnote—avatarUrl—isArchival—updatedAtformat YYYY-MM-DDTHH:mm:sscreatedAtformat YYYY-MM-DDTHH:mm:ssworkload2 fields
scheduledHours—workHours—status3 fields
statusOfTeacherId—nameOfStatus—showInWorkCalendar—chatsConnected chats; the table row shows their channel icons.4 fields
chatParticipantId—chatId—createdAtformat YYYY-MM-DDTHH:mm:sschatAlways present at runtime; optional because card selects are built dynamically
and TS cannot prove the nested object exists.5 fields
chatId—contactName—avatar—lastMessageAtformat YYYY-MM-DDTHH:mm:ssmessenger4 fields
messengerId—nameOfMessenger—typeOfMessengerOne of: TELEGRAM_BOT INSTAGRAM FACEBOOK IMESSAGEcapabilitiesWhat the channel supports; null when its adapter is not registered, so the chat is read-only.customFieldsCustom field values for the columns selected in the table preset.any keyscurl -X PATCH "https://your-school.rist.pro/api/teacher/1" \
-H "Authorization: Bearer $RIST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
}'const response = await fetch("https://your-school.rist.pro/api/teacher/1", {
method: "PATCH",
headers: {
Authorization: `Bearer ${process.env.RIST_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
}),
});
const { data } = await response.json();import os
import requests
response = requests.patch(
"https://your-school.rist.pro/api/teacher/1",
headers={"Authorization": f"Bearer {os.environ['RIST_API_KEY']}"},
json={
"firstName": "string",
"lastName": "string",
"middleName": "string",
"subjectIds": [
1
],
"contacts": [
{
"type": "PHONE",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"meetingLinkId": 1,
"statusOfTeacherId": 1,
"teacherReportStatusId": 1,
"note": "string",
"payoutMethod": "CARD",
"payoutRecipient": "string",
"payoutDetails": "string",
"payoutNote": "string",
"payoutAccountId": 1,
"customFields": {}
},
)
response.raise_for_status()
data = response.json()["data"]Response example · 200
{
"statusCode": 200,
"message": "Operation completed successfully",
"data": {
"teacherId": 1,
"firstName": "string",
"lastName": "string",
"middleName": "string",
"contacts": [
{
"type": "string",
"value": "string",
"label": "string"
}
],
"dateOfBirth": "2026-11-09T14:30:00",
"gender": "MALE",
"note": "string",
"avatarUrl": "string",
"isArchival": false,
"updatedAt": "2026-11-09T14:30:00",
"createdAt": "2026-11-09T14:30:00",
"workload": {
"scheduledHours": 0,
"workHours": 0
},
"status": {
"statusOfTeacherId": 1,
"nameOfStatus": "string",
"showInWorkCalendar": false
},
"chats": [
{
"chatParticipantId": 1,
"chatId": 1,
"createdAt": "2026-11-09T14:30:00",
"chat": {
"chatId": 1,
"contactName": "string",
"avatar": "string",
"lastMessageAt": "2026-11-09T14:30:00",
"messenger": {
"messengerId": 1,
"nameOfMessenger": "string",
"typeOfMessenger": "TELEGRAM_BOT",
"capabilities": {}
}
}
}
],
"customFields": {}
}
}