Work out an NCEA result: credits, the co-requisite, the certificate,
endorsements and UE, on NZQA's Assessment Rules 2026.
Use for: 'have I passed NCEA level 2', 'how many credits do I need for
NCEA', 'NCEA literacy and numeracy co-requisite', 'NCEA merit
endorsement', 'how many credits for excellence endorsement', 'course
endorsement NCEA', 'do I have University Entrance', 'NCEA calculator'.
60 CREDITS AT THE LEVEL OR ABOVE, PLUS THE CO-REQUISITE (10 LITERACY AND
10 NUMERACY, MET ONCE FOR EVERY LEVEL). NZQA's "80 credits" is 60 + 20.
The old rule of 80 credits alone is gone: 80 credits with no co-requisite
is not a certificate. Ask whether the co-requisite is met; if it was met
in an earlier year, or under the old rules in 2023 or earlier, pass 10
and 10. Do not put co-requisite credits in subjects.
50 GAINS A CERTIFICATE ENDORSEMENT, AND 49 DOES NOT, BUT ONLY WITH THE
CERTIFICATE. Excellence: 50 Excellence credits. Merit: 50 at Merit OR
Excellence, so Excellence credits count towards Merit. With 50 credits
but no certificate, *_endorsement_credits_met is true and
*_endorsement_earned is false: say it is awarded once the level is.
COURSE ENDORSEMENT IS 14 CREDITS IN ONE COURSE: Excellence at Excellence,
Merit at Merit or above, Achieved at any grade.
UE (LEVEL 3 ONLY): NCEA Level 3, three approved subjects each with 14+
credits, literacy of 5 reading AND 5 writing (not 10 in total), and 10
numeracy credits. Say which requirement is missing.
Not checked: the level of each standard, and the 3 internal and 3
external credits a course endorsement needs in most courses. New
qualifications replace NCEA from 2028 and are not modelled. For a rank
score, use nz_ncea_rank_score_calculator.
Args:
level: 1, 2 or 3.
subjects: List of {"name", "achieved", "merit", "excellence",
"ue_approved"}; credits that count towards the 60, whole numbers;
ue_approved is for Level 3 subjects on NZQA's approved list.
ue_literacy_reading_credits: Level 3: Level 2+ reading credits on the UE list.
ue_literacy_writing_credits: Level 3: Level 2+ writing credits on the UE list.
ue_numeracy_credits: Level 3: UE numeracy credits.
literacy_corequisite_credits: literacy co-requisite credits (need 10).
numeracy_corequisite_credits: numeracy co-requisite credits (need 10).
Returns:
Totals by grade, whether the 60 and the co-requisite are met, whether
the level is achieved and what is missing, both certificate
endorsements with credits still needed, each course endorsement, and
University Entrance at Level 3.
