How does Maditon read a supplier's document, and what is a finding?
Maditon fetches a copy of the supplier's published page, extracts the text and has Mistral read it in three passes: what the document states, what it leaves out that a document of its kind owes, and a summary. The result is a list of findings, each quoting the passage it rests on and graded high, medium or low. A finding is a question to put to the supplier — Maditon never declares a supplier compliant.
The reading is done in three stages, and keeping them apart is what makes the result checkable.
Extraction. The model pulls out what the document actually states — the retention period, the sub-processor notice, the transfer mechanism, the uptime commitment, the support channels — each fact paired with the passage it came from. Nothing enters the record without a quote.
Judgement. Only then does the model compare what was found with what a document of that kind owes. A data processing agreement owes the Article 28 terms; a terms-of-service page does not. Where the document is silent on something it owes, that silence becomes a finding marked not addressed. Where it says something that ought to worry you — a US transfer without a named mechanism, a notice period you cannot live with — that becomes a finding with the quote beside it.
Summary. A short plain-language account of what the document is and what the reading left open, written for the person who will decide what to do.
Every finding carries a severity — high, medium or low — and a suggested question for the supplier. That framing is deliberate: a published page can show what a supplier has committed to in writing, never what it does in practice, so a finding is the start of a conversation, not a verdict. E-mail addresses and phone numbers are masked before any text reaches the model, and the reading runs on Mistral’s EU endpoint with training on submitted data switched off.
Related API endpoints
/api/vendor-documents/{document_id}/assess bearer Read a document and produce its findings
/api/vendor-documents/{document_id}/assessment bearer The current reading of a document
/api/vendor-documents/{document_id}/snapshot bearer The text the reading quotes, paragraph by paragraph
Base URL https://api.maditon.app ·
full specification at openapi.json
Regulation references
- Regulation (EU) 2016/679 (GDPR) · Art. 28 · CELEX 32016R0679
- Directive (EU) 2022/2555 (NIS2) · Art. 21 · CELEX 32022L2555
Read next
A free account runs a real classification on one of your own systems — no card, no sales call.
Run a free classification