Skip to navigation
API ReferenceAward Cycles

Get the current award cycle.

Returns a single AwardCycleV1 resource. The lookup prefers the cycle the institution has marked current; when none is marked current it falls back to the cycle marked next. When neither exists the endpoint returns 404 award_cycle_not_found in the structured v1 error shape — in that case list all cycles via GET /api/v1/award-cycles and ask the user which one to use.

Assistant capability: springiq_get_current_award_cycle.

Authentication

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

Response

OK
objectstring or nullOptionalRead-only

Stripe-style resource discriminator. Stable, snake_case string naming the resource type. Serialized first so it reads as the leading field of every V1 resource body.

idstring or nullOptional

The award cycle’s stored ID. Example: "4MZ8QW2TC".

namestring or nullOptional

Award-cycle name as configured by the institution (e.g. “2025-2026”).

is_currentbooleanOptional
True when this is the cycle the institution has marked current.
is_nextbooleanOptional

True when this is the cycle the institution has marked next/upcoming.

application_start_dateinteger or nullOptional

When the cycle’s application window opens (UTC epoch seconds), or null when unset.

application_end_dateinteger or nullOptional

When the cycle’s application window closes (UTC epoch seconds), or null when unset.

review_start_dateinteger or nullOptional

When the cycle’s review window opens (UTC epoch seconds), or null when unset.

review_end_dateinteger or nullOptional

When the cycle’s review window closes (UTC epoch seconds), or null when unset.

Errors

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