Skip to content
papii

Document template · generic.customer.nps_report

NPS Report

  • Render-verified
  • Commercial
  • Version 1.0.0

Periodic Net Promoter Score (NPS) report produced by a vendor's Customer Success team. Captures respondent counts, the NPS score (-100..+100), promoter/passive/detractor percentages, the 0-10 score distribution, promoter and detractor themes, anonymised verbatim samples with score, an action plan and the report author. Follows the standard Bain/NPS definitions (promoters 9-10, passives 7-8, detractors 0-6). Non-regulated commercial document — no statutory source.

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

Field Required Type Description
vendor Required object
vendor.name Required string
vendor.address Required string
vendor.contact_email Required string
period Required object
period.start Required date
period.end Required date
period.label Required string
respondents_total Required integer
nps_score Required number
promoters_pct Required number
passives_pct Required number
detractors_pct Required number
distribution Required array of object
distribution[].score Required integer
distribution[].count Required integer
top_themes_promoters Required array of string
top_themes_detractors Required array of string
verbatim_samples Required array of object
verbatim_samples[].score Required integer
verbatim_samples[].quote Required string
verbatim_samples[].anonymised_role Required string
action_plan Required array of string
report_author Required object
report_author.name Required string
report_author.title Required string
report_author.date Required date

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

Frequently asked questions

What is “NPS Report”?

Periodic Net Promoter Score (NPS) report produced by a vendor's Customer Success team. Captures respondent counts, the NPS score (-100..+100), promoter/passive/detractor percentages, the 0-10 score distribution, promoter and detractor themes, anonymised verbatim samples with score, an action plan and the report author. Follows the standard Bain/NPS definitions (promoters 9-10, passives 7-8, detractors 0-6). Non-regulated commercial document — no statutory source. On papii this document is available as template generic.customer.nps_report: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a NPS Report 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 NPS Report 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.