Skip to navigation

List applications.

Returns one page at a time. Each row names the scholarship and award cycle it belongs to, and carries a status of applied, awarded, or denied. Without filters the list covers the whole institution; narrow it with user_id (a student’s id from the Students endpoints) to scope to a single student. Returns 404 student_not_found, naming user_id in param, when the user_id is not a student at this institution.

Assistant capability: springiq_list_student_applications. Required permission: Users (applies when called on behalf of a signed-in person).

Authentication

X-Spring-API-Keystring
Secret API key issued per institution. Send it on every request.

Query parameters

user_idstringOptional

Optional student scope (?user_id=): the student’s id from the Students endpoints. Omit for a tenant-wide list.

limitintegerOptional1-100Defaults to 25

Page size. Defaults to 25. Values outside 1–100 are clamped rather than rejected.

starting_afterstringOptional

Opaque cursor. Pass the next_cursor from the previous page to page forward. Mutually exclusive with ending_before; if both are supplied, starting_after wins.

ending_beforestringOptional

Opaque cursor. Pass the previous_cursor from the current page to page backward.

includelist of enumsOptional

Optional extras to add to the response, comma-separated. total_count is the only supported value: it adds total_count, the number of records that match this request across all pages. The count is taken fresh at the moment of each request, so it can change while you page; ask for it on the first page. Without it, total_count is left out of the response. Asking or not never invalidates a cursor. Any other value returns 400 validation_failed.

Allowed values:

Response

OK
objectstring or nullOptionalRead-only

Discriminator constant. Always "list", mirroring Stripe’s list objects.

urlstring or nullOptional

The request path this collection was served from (e.g. /api/v1/scholarships).

has_morebooleanOptional
True when another page exists in the current paging direction.
next_cursorstring or nullOptional

Opaque cursor for the next page (pass as starting_after). Null when there is none.

previous_cursorstring or nullOptional

Opaque cursor for the previous page (pass as ending_before). Null when there is none.

total_countinteger or nullOptional

The number of records that match the request across all pages, counted fresh on each request. Present only when the request includes include=total_count; otherwise the key is omitted.

datalist of objects or nullOptional
The page of items.

Errors

400
Bad Request Error
404
Not Found Error
429
Too Many Requests Error