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.

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.

idintegerOptional

AwardSpring award-cycle identifier — also the cursor anchor for paging.

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_datedatetime or nullOptional

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

application_end_datedatetime or nullOptional

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

review_start_datedatetime or nullOptional

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

review_end_datedatetime 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