Accessing attendance lists
:: services/attendance module

These API methods allow you to create and fill attendance lists.

Methods

attendance BETA Get information of attendance.
attendance_list (deprecated) BETA Get information of a single attendance list.
attendance_list2 BETA Get information of a single attendance list.
attendance_lists (deprecated) BETA Get information of multiple attendance lists.
attendance_lists2 BETA Get information of multiple attendance lists.
attendance_summaries BETA Get attendance summaries.
change_list_mode BETA Change mode of attendance list. This requires no set attendance for that list.
course_unit BETA Get information of attendance lists for selected course unit.
create_attendance_list BETA Create a new attendance list.
create_from_tt (deprecated) BETA Create new attendance lists from group meetings.
create_from_tt2 BETA Create new attendance lists from multiple groups meetings.
delete_attendance BETA Delete attendance entry.
delete_list BETA Delete attendance list. This requires no set attendance for that list.
group (deprecated) BETA Get information of attendance lists for selected group.
group2 BETA Get information of attendance lists for selected group.
student_attendances BETA Get summary of student's attendance on a course unit.
update_attendance BETA Update attendance entry.
update_attendances BETA Update mode of all attendance entries on a list for specified group of students. This method does not support comments changing.
update_student_attendances BETA Update student's attendances for all general and current group's lists.
user (deprecated) BETA Get all attendance lists for user.
user2 BETA Get all attendance lists for user.

services/attendance/attendance

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of attendance.
list_id required ID of attendance list
student_ids optional Pipe-separated list of student IDs
include_non_members optional

Default value: false

Flag that allows to retrieve existing records for students who were previously entered but are no longer included in the list
fields optional

Default value: student|warden|attendance_mode

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of entries for specified attendance list. Each entry will be a dictionary of selected fields and their values.

If student_ids was set, then the list will be filtered to specified students.

Available fields:

  • student - student who the entry concerns.

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • warden - person responsible for the entry modification.

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • attendance_mode - mode of attendance in the meeting.

    Possible values:

    • intramural - the person was in faculty building

    • remote - the person paticipated in meeting remotely

    • justified_absence - the person was not present at the meeting, but justified their absence

    • absence - the person was not present at the meeting

    • null - the attendance was not set for this person

  • comment - comment or null if no comment was provided.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/attendance_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

This method is deprecated, please avoid using it - read more

Suggested replacement: services/attendance/attendance_list2

Deprecation reason: This method does not support general lists (lists with no group number) and still manages lists' 'owner' field despite it was removed from the model.

Get information of a single attendance list.
list_id required ID of attendance list
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • id - ID of the attendance list;

  • course_unit - Course unit.

    This field references objects returned by services/courses/course_unit method. See its returns section for possible subfields (only primary are allowed).

  • group_number - Group number;

  • owner - Owner of the attendance list. Since the model does not provide for the field anymore, returned value can be fake..

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • date - Datetime of meeting, in datetime format;

  • mode - mode of meetings of the class group.

    Possible values:

    • intramural - the meetings are conducted in faculty building

    • remote - the meetings are conducted remotely

    • hybrid - mix of the first two options, some students can be in faculty building, while others can attend remotely

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/attendance_list2

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance_list2

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of a single attendance list.
list_id required ID of attendance list
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • id - ID of the attendance list;

  • course_unit - Course unit.

    This field references objects returned by services/courses/course_unit method. See its returns section for possible subfields (only primary are allowed).

  • group_number - Group number;

  • date - Datetime of meeting, in datetime format;

  • has_any_entries - Information whether the attendance list has any entries or not;

  • mode - mode of meetings of the class group.

    Possible values:

    • intramural - the meetings are conducted in faculty building

    • remote - the meetings are conducted remotely

    • hybrid - mix of the first two options, some students can be in faculty building, while others can attend remotely

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/attendance_lists

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance_lists

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

This method is deprecated, please avoid using it - read more

Suggested replacement: services/attendance/attendance_lists2

Deprecation reason: This method does not support general lists (lists with no group number) and still manages lists' 'owner' field despite it was removed from the model.

Get information of multiple attendance lists.
list_ids required Pipe-separated list of attendance list IDs.
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary: your list_ids will be mapped to dictionary's keys, and each value will contain the description of one attendance list, as defined in the attendance_list method.

For invalid list_ids (attendance lists which do not exist) null will be returned (instead of the attendance list object).

services/attendance/attendance_lists2

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance_lists2

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of multiple attendance lists.
list_ids required Pipe-separated list of attendance list IDs.
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list2 method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary: your list_ids will be mapped to dictionary's keys, and each value will contain the description of one attendance list, as defined in the attendance_list2 method.

For invalid list_ids (attendance lists which do not exist) null will be returned (instead of the attendance list object).

services/attendance/attendance_summaries

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/attendance_summaries

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get attendance summaries.
course_unit_id required ID of course unit
student_ids optional Pipe-separated list of student IDs
fields optional

Default value: student

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of students' attendance summaries for specified course unit. Each summary will be a dictionary of selected fields and their values.

If student_ids was set, then the list will be filtered to specified students.

Available fields:

  • student - student who the entry concerns.

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • attendances - number of attendances;

  • absences - number of absences;

  • justified_absences - number of justified absences;

  • unknown - number of unknown statuses;

  • total_attendance - Total attendance percentage;

  • lists_number - Total number of lists for a student;

  • has_unresolved_entries - Information whether the student has any entries on lits of other groups.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • course_unit_not_found - specified course unit does not exist or user is not its lecturer nor coordinator.

services/attendance/change_list_mode

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/change_list_mode

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Change mode of attendance list. This requires no set attendance for that list.
list_id required ID of attendance list
mode required Mode of meeting, as described in attendance_list

Possible values: intramural, remote, hybrid.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dict on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • has_entries - the attendance list has entries.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/course_unit

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/course_unit

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of attendance lists for selected course unit.
course_unit_id required ID of course unit
general_only optional

Default value: false

Return only general lists
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list2 method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list2 method.

services/attendance/create_attendance_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/create_attendance_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Create a new attendance list.
course_unit_id required ID of course unit
date required Date and time of the meeting
mode required Mode of meeting, as described in attendance_list

Possible values: intramural, remote, hybrid.
group_number optional Group number
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of the following structure:

  • list_id - ID of created attendance list.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • already_exists - the attendance list already exists;

    • no_students - the group does not have any participants.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • course_unit_group_not_found - specified combination of course and group does not exist or user is not its lecturer nor coordinator.

services/attendance/create_from_tt

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/create_from_tt

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

This method is deprecated, please avoid using it - read more

Suggested replacement: services/attendance/create_from_tt2

Deprecation reason: This method does not support creating lists for multiple groups simultaneously.

Create new attendance lists from group meetings.
course_unit_id required ID of course unit
group_number required Group number
default_mode required Mode of meetings in the classgroup, as described in attendance_list

Possible values: intramural, remote, hybrid.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

An empty dictionary if the entries were successfully created.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • no_students - the group does not have any participants.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • course_unit_group_not_found - specified combination of course and group does not exist or user is not its lecturer nor coordinator;

    • meeting_not_found - specified course group has no meetings.

services/attendance/create_from_tt2

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/create_from_tt2

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Create new attendance lists from multiple groups meetings.
course_unit_id required ID of course unit
group_numbers required Group numbers
default_mode required Mode of meetings in the classgroup, as described in attendance_list

Possible values: intramural, remote, hybrid.
dry_run optional

Default value: false

Disable saving created lists. Useful to calculate the number of new attendance lists that would be created by this method.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

If the dry_run param is set to True, a dictionary of the following structure:

  • lists_number - int, number of list objects that would be created.

Otherwise, an empty dictionary on success

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • no_students - the group does not have any participants.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • course_unit_group_not_found - specified combination of course and group does not exist or user is not its lecturer nor coordinator;

    • meeting_not_found - specified course group has no meetings.

services/attendance/delete_attendance

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/delete_attendance

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Delete attendance entry.
list_id required ID of attendance list
student_id required ID of student
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dictionary on success.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_entry_not_found - Entry for this list and student does not exist;

    • attendance_list_not_found - attendance list does not exist.

services/attendance/delete_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/delete_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Delete attendance list. This requires no set attendance for that list.
list_id required ID of attendance list
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dict on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • has_entries - the attendance list has entries.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/group

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/group

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

This method is deprecated, please avoid using it - read more

Suggested replacement: services/attendance/group2

Deprecation reason: This method does not support general lists (lists with no group number) and still manages lists' 'owner' field despite it was removed from the model.

Get information of attendance lists for selected group.
course_unit_id required ID of course unit
group_number required Group number
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list method.

services/attendance/group2

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/group2

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of attendance lists for selected group.
course_unit_id required ID of course unit
group_number required Group number
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list2 method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list method.

services/attendance/student_attendances

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/student_attendances

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get summary of student's attendance on a course unit.
course_unit_id required ID of course unit
student_id optional ID of student
fields optional

Default value: attendance

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of entries for specified course unit, where keys are lists' ids and values are dictionaries of selected fields and their values.Available fields:

  • list - Attendance list of entry.

    This field references objects returned by attendance_list2 method. See its returns section for possible subfields.

  • attendance - Attendance.

    This field references objects returned by attendance method. See its returns section for possible subfields.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • course_unit_not_found - specified course unit does not exist or user is not its lecturer nor coordinator;

    • student_not_found - student does not exist, is not allowed to attend course or is not in a specified group.

services/attendance/update_attendance

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/update_attendance

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Update attendance entry.
list_id required ID of attendance list
student_id required ID of student
attendance_mode required Mode of attendance in the meeting.

Possible values: intramural, remote, justified_absence, absence.
comment optional Comment
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dictionary on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • intramural_attendance_not_allowed - intramural attendance is not allowed in this attendance list;

    • remote_attendance_not_allowed - remote attendance is not allowed in this attendance list;

    • student_not_in_group - student is not in group for specified attendance list.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/update_attendances

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/update_attendances

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Update mode of all attendance entries on a list for specified group of students. This method does not support comments changing.
list_id required ID of attendance list
attendance_mode required Mode of attendance in the meeting.

Possible values: intramural, remote, justified_absence, absence.
target_group optional

Default value: unknown_status

Group of students to update

Possible values: all, unknown_status.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dictionary on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • intramural_attendance_not_allowed - intramural attendance is not allowed in this attendance list;

    • remote_attendance_not_allowed - remote attendance is not allowed in this attendance list;

    • student_not_in_group - student is not in group for specified attendance list.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/update_student_attendances

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/update_student_attendances

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Update student's attendances for all general and current group's lists.
course_unit_id required ID of course unit
attendance_mode required Mode of attendance in the meeting.

Possible values: presence, absence, justified_absence.
student_id optional ID of student
target_lists optional

Default value: unknown_status

Group of lists to update entries for

Possible values: all, unknown_status.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

An empty dictionary on success.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_entry_not_found - Entry for this list and student does not exist;

    • course_unit_not_found - specified course unit does not exist or user is not its lecturer nor coordinator;

    • student_not_found - student does not exist, is not allowed to attend course or is not in a specified group.

services/attendance/user

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/user

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

This method is deprecated, please avoid using it - read more

Suggested replacement: services/attendance/user2

Deprecation reason: This method does not support general lists (lists with no group number) and still manages lists' 'owner' field despite it was removed from the model.

Get all attendance lists for user.
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list method.

services/attendance/user2

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://usosapi.ans.edu.pl/services/attendance/user2

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get all attendance lists for user.
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list2 method.

format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional

Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list method.
USOS API ver. 7.3.1.0-3, ca86882b (2026-11-02)