Result declared → one statement per student, the same day
Trigger → artefact
A result is declared for a cohorta statement of marks per student, with the result derived from the marks
Every institution has the marks in a table already. What takes the weeks is the document: one per student, each with its own grades, its own credit arithmetic, its own average — and a mistake in any of them is one a family notices and a registrar has to answer for.
Here the caller sends the marks and the grade scale. The document computes the percentage, picks the band, weights the grade points by credits, and states the result in words. Send a grade or an SGPA of your own and the render is refused with the field named, because a grade typed by the payload is a grade nobody downstream can verify.
What ships in this category
Subject-wise internal and external marks, credits, the derived percentage and grade, the credit-weighted SGPA and CGPA, credits earned, and the pass-or-reappear result — with the grade scale printed so the reader can repeat the derivation.
Hard part The credit-weighted SGPA and the pass-or-reappear result, derived from the marks and the scale — never sent by the caller.
template_id d0000001-0000-4b00-a000-000000000011
The document a learner shares: programme, completion date, study hours, result and credential id, with the assessments that were passed listed underneath and a QR to the verification page.
Hard part A credential id and verification URL printed as a QR the issuer controls, so the certificate can be checked years later.
template_id d0000002-0000-4b00-a000-000000000005
The whole integration
# once per student, when the result is declared
curl https://api.pixldocs.com/v1/render \
-H "Authorization: Bearer $PIXLDOCS_KEY" \
-H "Content-Type: application/json" \
-d '{
"template_id": "d0000001-0000-4b00-a000-000000000011",
"format": "pdf",
"data": {
"student_name": "Sofia Marchetti",
"semester": "Semester 5",
"pass_percent": 40,
"subjects": [
{ "code": "3150706", "title": "Computer Networks", "credits": 3,
"max_marks": 70, "marks": 22, "max_internal": 30, "internal_marks": 14 }
],
"grade_scale": [
{ "min_percent": 40, "grade": "DD", "points": 4 },
{ "min_percent": 0, "grade": "FF", "points": 0, "is_fail": "yes" }
]
}
}' --output marksheet.pdfRun against the API before publishing: 200, application/pdf — and that subject comes back at 36.0%, grade FF, no credits earned and the statement reading REAPPEAR, without the payload saying so anywhere.
The contract
These templates take named keys — no positional arguments, no layout to describe. Send a row array and the pagination follows it.
d0000001-0000-4b00-a000-000000000011Fields · 26
Rows · subjects[]
code · title · category · credits · max_marks · marks · max_internal · internal_marks
Send as many as you have. Pagination, running totals and the carried-forward header are the renderer's problem, not yours.
Rows · grade_scale[]
min_percent · grade · points · descriptor
Send as many as you have. Pagination, running totals and the carried-forward header are the renderer's problem, not yours.
Rows · previous_semesters[]
label · credits · points
Send as many as you have. Pagination, running totals and the carried-forward header are the renderer's problem, not yours.
d0000002-0000-4b00-a000-000000000005Fields · 18
Rows · criteria[]
item
Send as many as you have. Pagination, running totals and the carried-forward header are the renderer's problem, not yours.
Rows · signatories[]
name · role
Send as many as you have. Pagination, running totals and the carried-forward header are the renderer's problem, not yours.
Because then two systems decide a student’s result, and one day they disagree on a document with a registrar’s name on it. Send the marks and the scale and there is one answer, printed beside the scale it came from. A row carrying its own grade is a 400 with the field named.
The scale is data, not code. Bands, thresholds, grade points, which band counts as a fail, and the pass mark are all fields on the request, so one template serves several programmes. Send no scale at all and the document prints marks and percentages and states plainly that no grade was awarded — it will not invent one.
Send the previous semesters as credits and grade points and the CGPA is the credit-weighted mean. If one of them is missing either figure, no CGPA is printed at all and the statement says why — an average quietly short a semester is worse than no average.
We tested sixty: six pages, the column header repeating on each, the running header carrying the student and statement number, and totals and SGPA that still reconcile.
Templates are versioned. Publish a new version when the ordinance changes and pin the old one to reproduce a historical statement byte for byte — which is what a verification request years later actually needs.
Free to start · No credit card required