Study credits info
:: services/credits module

These methods allow you to access your study credits information:

  • Sum of ECTS credits used on a given programme or in general
  • More will be available in the future...

Methods

student_programme Get sums of credits used on the given student programme. (administrative)
used_sum Get the sum of credits used

services/credits/student_programme

Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: not required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.
Returns dictionary with numbers of credits used on specified student programme
students_programme_id required ID of students programme.
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. Token is not required.

Returned value:

A dictionary of selected result fields and their values.

Available fields:

  • students_programme_id - ID of students_programme
  • used_external_credits - ECTS used on previous programs in the framework of this eligibility
  • course_credits - ECTS used on the selected program - courses
  • external_course_credits - ECTS used on the selected program - external courses
  • decisions_credits - ECTS used on the selected program - decisions
  • paid_by_ministry - Dictionary describing in details ECTS points paid by ministry
  • paid_by_university - Dictionary describing in details ECTS points paid by university
  • paid_by_student - Dictionary describing in details ECTS points paid by student
  • paid_by_no_one - Dictionary describing in details ECTS points paid by no one
  • diploma_credits - ECTS used on diploma and final exam

services/credits/used_sum

Consumer: required Token: required Scopes: none SSL: not required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.

Returns the sum of ECTS credits based on the course's that have been linked to a specified programme and passed. Details of this calculations can be, in some cases, complex and are defined according to an act. This sum is used for a study declaration that is required to study free of charge.

If neither of the optional parameters is used than we return the overall sum that takes into account all of the student's programmes. User token is required in that situation.

students_programme_id optional

If this parameter is used credits sum will be based only on the courses linked to this student's programme.

programme_id deprecated

This parameter is deprecated. Use students_programme_id instead.

Note that you cannot use both programme_id and students_programme_id!

ID of a student programme.

If this parameter is used than:

  • credits sum will be based only on the courses linked to this programme,
  • user token has to be passed.

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:

Sum of ECTS credits as a decimal number.

USOS API ver. 6.6.0.0-11, 83b82554, dirty (2020-12-21)