Templates › Report

Report template

A structured report with cover page, optional key-figures strip, and sections written in Markdown (headings, lists, tables, code). Good for monthly client reports, audits and summaries generated from your data.

Preview the sample PDF Get a free API key

Fields

Field	Type	Required	Description
`title`	string	yes	Report title (cover page)
`subtitle`	string	no	Cover subtitle, e.g. the period
`author`	string	no	Prepared by
`client`	string	no	Prepared for
`date`	string (YYYY-MM-DD)	no	Report date
`summary`	string (Markdown)	no	Executive summary shown first
`kpis`	array	no	[{label, value, note}] shown as a strip of figures
`sections`	array	yes	[{heading, body}] — body is Markdown
`logo`	string (data:image/... URI)	no	Logo on the cover
`accent`	string (CSS color)	no	Heading colour, default #0b5c6b

Sample request

POST https://docpress.dev/v1/pdf
Authorization: Bearer dp_your_key
Content-Type: application/json

{
  "template": "report",
  "data": {
    "title": "Website Performance Report",
    "subtitle": "September 2026",
    "author": "Northwind Studio",
    "client": "Acme Robotics Inc.",
    "date": "2026-10-01",
    "summary": "Organic traffic grew for the third month in a row while the checkout error rate fell after the September release. Two items need a decision this month: the image CDN migration and the search page redesign.",
    "kpis": [
      {
        "label": "Sessions",
        "value": "48,210",
        "note": "+12% vs Aug"
      },
      {
        "label": "Conversion",
        "value": "2.8%",
        "note": "+0.3 pt"
      },
      {
        "label": "Checkout errors",
        "value": "0.4%",
        "note": "\u22121.1 pt"
      },
      {
        "label": "Median LCP",
        "value": "1.9 s",
        "note": "target 2.5 s"
      }
    ],
    "sections": [
      {
        "heading": "Traffic",
        "body": "Sessions rose to **48,210**. The largest gains came from the documentation pages published in August.\n\n| Channel | Sessions | Change |\n|---|---|---|\n| Organic search | 29,400 | +18% |\n| Direct | 11,050 | +4% |\n| Referral | 7,760 | +9% |"
      },
      {
        "heading": "Checkout reliability",
        "body": "The September release fixed the address-validation timeout. Error rate fell from 1.5% to 0.4%.\n\n- Remaining errors are concentrated on one payment method.\n- A retry was added for the tax-calculation call."
      },
      {
        "heading": "Decisions needed",
        "body": "1. **Image CDN migration** \u2014 estimated 0.3 s LCP improvement, two days of work.\n2. **Search page redesign** \u2014 prototype ready for review."
      }
    ]
  }
}

Add "page_size": "Letter" next to template to change the paper size. Output on the free plan carries a small footer mark. See the API docs for authentication and errors.