Skip to content
papii

Document template · generic.hr.reference_request

Reference Request

  • Render-verified
  • Informational
  • Version 1.0.0

Formal written request to a prior employer seeking a professional reference about a job candidate. Includes explicit candidate-consent statement and GDPR-aligned processing note.

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 30 fields:

Field Required Type Description
requesting_employer Required object
requesting_employer.name Required string
requesting_employer.address Required string
requesting_employer.reference Optional string
prior_employer Required object
prior_employer.name Required string
prior_employer.address Required string
addressee Required object
addressee.name Required string
addressee.role Optional string
candidate Required object
candidate.name Required string
candidate.date_of_birth Required date
candidate.employee_id_at_prior Optional string
candidate.role_at_prior Required string
candidate.employment_start Required date
candidate.employment_end Required date
role_being_filled Required object
role_being_filled.title Required string
role_being_filled.department Optional string
consent Required object
consent.signed_on Required date
letter_date Required date
questions Required array of string
response_deadline Required date
requester Required object
requester.name Required string
requester.role Required string
requester.email Required string
requester.phone Optional string

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_request",
    "data": { ... },
    "options": {"language": "en"}
  }' -o reference-request.pdf
Generate with AI on chut.app Try in the dashboard

Frequently asked questions

What is “Reference Request”?

Formal written request to a prior employer seeking a professional reference about a job candidate. Includes explicit candidate-consent statement and GDPR-aligned processing note. On papii this document is available as template generic.hr.reference_request: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Reference Request 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 Request 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.