Committees
:: services/committees module

This is a BETA module. 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 module, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Retrieving information and members of committees. Note that only active committees and members are accessible.

Methods

committee BETA Get information on given term committee
committees_index BETA Get IDs of all term committees
function BETA Get information on given committee function
member BETA Get members of a given term committee (administrative)

services/committees/committee

Consumer: optional Token: optional 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.

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 on given term committee
id required ID of term committee
fields optional

Default value: name|start_date|faculty|id|end_date|functions

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 optional standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • Primary:

    • name - Name of the committee;

    • start_date - Start date of the committee term;

    • faculty - ID of organizational unit.

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

    • id - ID of a committee;

    • end_date - End date of the committee term.

  • Secondary:

    • members - List of committee members.

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

    • functions - List of committee functions.

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

Thrown errors:

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

    Possible reasons:

    • committee_not_found - referenced term committee does not exist.

services/committees/committees_index

Consumer: optional Token: optional 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.

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 IDs of all term committees
faculty_id optional

Default value: (empty string)

Id of a faculty
with_subfaculties optional

Default value: false

If true, committees of subfaculties will be also on the list
fields optional

Default value: name|start_date|faculty|id|end_date

Selector of result fields you are interested in. The selector must contain subset of primary fields, which are described in the returns section of committee 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 optional standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization.

Returned value:

List of related committees

Thrown errors:

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

    Possible reasons:

    • committee_not_found - referenced term committee does not exist.

services/committees/function

Consumer: optional Token: optional 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.

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 on given committee function
id required ID of committee function
fields optional

Default value: id|name

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 optional standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • id - ID of function;

  • name - Name of function.

Thrown errors:

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

    Possible reasons:

    • function_not_found - referenced committee function does not exist.

services/committees/member

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: 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.

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 members of a given term committee
committee_id required ID of term committee
user_id optional

Default value: (access token issuer)

ID of user
fields optional

Default value: user|committee_id|function_id|start_date|end_date|comment

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. Token is not required.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • user - a user object.

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

  • committee_id - ID of term committee;

  • function_id - ID of committee function;

  • start_date - Start date of membership;

  • end_date - End date of membership;

  • comment - Additional remarks.
USOS API ver. 7.2.0.0-0, 4e55d958, dirty (2025-07-24)