Get registration year settings

GET

https://ssuccessv2.com/app/api/v2/registration/year/settings/:year_id

Returns the selected academic year's dates, registration phase settings, discount configuration, and ordered registration steps for the active school.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Path parameters

year_idintegerRequired>=1

Academic year identifier.

Query parameters

registration_phase_idintegerOptional>=1

Optional registration phase to resolve.

Response

Registration year settings were returned.

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

1	{
2	"status": "success",
3	"message": "",
4	"data": {
5	"registration_opens": {},
6	"registration_closes": {},
7	"start_at": {},
8	"end_at": {},
9	"title": "2026-2027",
10	"early_bird_ends": {},
11	"early_bird_discount": 10,
12	"early_bird_discount_type": "percentage",
13	"early_bird_contract_fees_type_ids": [
14	2
15	],
16	"registration_phase_id": 3,
17	"registration_steps": [
18	"family",
19	"students",
20	"contract"
21	]
22	}
23	}

$	curl https://ssuccessv2.com/app/api/v2/registration/year/settings/12 \
>	-H "Authorization: Bearer <token>"