Skip to content
papii

Document template · generic.hr.reference_letter

Reference Letter

  • Render-verified
  • Official document
  • Version 1.0.0

Formal positive reference written by a prior employer or supervisor at the candidate's request, with relationship, role summary, strengths, achievements and explicit endorsement.

JSON Schema

Fields in this template

Data sent to the API is validated against the template’s JSON Schema before anything is rendered. This template defines 21 fields:

Field Required Type Description
referee_employer Required object
referee_employer.name Required string
referee_employer.address Required string
referee Required object
referee.name Required string
referee.role Required string
referee.email Required string
referee.phone Optional string
letter_date Required date
employment Required object
employment.role Required string
employment.start_date Required date
employment.end_date Required date
employment.summary_of_duties Required string
relationship_summary Required string
strengths Required array of object
strengths[].area Required string
strengths[].evidence Required string
notable_achievements Optional array of string
endorsement Required string
further_contact_offer Optional boolean

POST /render

Generate it

One POST /render call: send your JSON, get the finished PDF back. Or skip the JSON entirely and describe the document in plain language on chut.app.

curl 
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "generic.hr.reference_letter",
    "data": { ... },
    "options": {"language": "en"}
  }' -o reference-letter.pdf
Generate with AI on chut.app Try in the dashboard

Frequently asked questions

What is “Reference Letter”?

Formal positive reference written by a prior employer or supervisor at the candidate's request, with relationship, role summary, strengths, achievements and explicit endorsement. On papii this document is available as template generic.hr.reference_letter: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Reference Letter with AI?

Yes. chut.app — the AI back office papii powers — fills this template from a plain-language description: you describe the document in one sentence, the AI structures the data, papii validates it against the schema and renders the PDF. Developers can also call the papii API directly with structured JSON.

Is the Reference Letter template legally compliant?

This template is render-verified: its schema, sample data and PDF output are automatically tested on every release. It is published with status “ready”, meaning it has not yet been through papii’s final legal review. Where it references specific legislation, that is stated in the template description — always have a professional check documents with legal effect before relying on them.