Create a report-card batch

POST

https://ssuccessv2.com/app/api/v1/report-card/batches

Creates a report-card batch, attaches subjects/classes/nodes, stores grading overrides, and synchronizes class and grade teacher assignments in one transaction.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired<=255 characters

languagestringRequired

show_school_namebooleanRequired

show_academic_yearbooleanRequired

general_commentsbooleanRequired

subject_commentsbooleanRequired

attendancebooleanRequired

report_card_term_idintegerRequired

academic_year_idintegerRequired

subject_idslist of integersRequired

parent_signaturebooleanRequired

school_messagestring or nullOptional

attendance_optionsobject or nullOptional

class_teacherslist of objects or nullOptional

grade_teacherslist of objects or nullOptional

nodeslist of integers or nullOptional

classeslist of integers or nullOptional

grading_overrideslist of objects or nullOptional

Response

Batch created and transaction committed

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

$	curl -X POST https://ssuccessv2.com/app/api/v1/report-card/batches \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Fall 2026 Report Cards",
>	"language": "en",
>	"show_school_name": true,
>	"show_academic_year": true,
>	"general_comments": true,
>	"subject_comments": true,
>	"attendance": true,
>	"report_card_term_id": 3,
>	"academic_year_id": 2026,
>	"subject_ids": [
>	11,
>	12,
>	13
>	],
>	"parent_signature": true
>	}'

1	{
2	"status": "success",
3	"message": "Created",
4	"data": {
5	"id": 310
6	}
7	}