Skip to content
UGP v1.0 is a public comment draft. Comments close November 23, 2026. The A–D defect counts are provisional.Public comment draft · until November 23, 2026Comment on this draftComment →
UGPUniversal Grading Protocol
AnnexesNormativeAnnex B

JSON record schema

PDF

The outline of the JSON record schema published at /schema/v1.0/record.json.

Normative outline.

The schema is published at the permanent home as /schema/v1.0/record.json (JSON Schema 2020-12). It contains:

  • ugp_version, profile, profile_status, record_scope;
  • identity{…, blacklist{status, basis, source, checked_at}}, where status is clear, reported or unchecked and basis says how clear was reached: measured or evidenced (a check) or declared (§4.1, §9.3);
  • axes:
    • cosmetic{value, basis, zones{AA,A,B,C,…}[defects], mapped_from{scale, value, crosswalk}?}, with mapped_from set only on a supplier-mapped grade (§13.6)
    • functional{status, faults[]}
    • battery{health_pct, basis, cells[], replaced}
    • locks{value, types[]}
    • operator{value, carrier}
    • data{value, method, technique, tool, certificate_id, standard_rev}
    • parts{value, manifest[]}
    • kit{value, components[]}
  • result{status, reasons[], grade, premium, core_code, ctia_derived?};
  • audit{grader_id, graded_at, method, verification_tier, conformance, tolerance_table}.

The grade, status and core code in result are derived values and shall match the derivation in §11–12.