Integration · Document Fraud Detection

Document fraud detection API: where it plugs into intake and payment

A document fraud detection API earns its keep only if it runs between the moment a document arrives and the moment it is paid. This guide maps where Document Fraud Detection connects to claim intake and claim systems, what it reads, the one thing it writes back, and what stays with your systems and your people.

Updated · 13 min read

A document fraud detection API is the interface through which a claims system sends a document, with enough claim context to judge it, to a testing service, and gets back a verdict and the evidence behind it. For an insurer the call itself is the easy part. What decides its value is where it sits: between the moment an invoice, bill, estimate or receipt arrives and the moment someone pays on it. A check that runs after payment can only start a recovery. Document Fraud Detection is Botminds' solution for testing claim documents before payment. It picks documents up from the portal, email, vendor uploads and bill feeds, reads the claim system and the registers it needs, and writes back one thing: a pass, question or refer verdict with each finding pinned on the page and a note drafted for a person to sign. It never holds a payment or refers a claim by itself.

Where Document Fraud Detection sits: from intake to payment, and who acts

  1. Agent

    Intake

    Takes each claim document over the threshold from portal, email, vendor upload or bill feed; keeps the original and its SHA-256 fingerprint.

    Never: changes the original

  2. Agent

    Check

    Reads fields with positions, tests the file, recomputes the sums, looks up vendor and claim facts, searches past documents.

  3. Agent

    Note

    Applies the fixed verdict rules and writes back the verdict, findings and a drafted note or referral.

    Never: holds a payment or refers by itself

  4. A person decides

    Adjuster

    Pass is released; on a question or refer, decides: pay, hold, ask the vendor or refer.

  5. A person decides

    Payment

    Runs in the claim system as today. Paying against a refer needs a second approval.

As configured in Document Fraud Detection. The claim system keeps payment authority; the API adds evidence before the payment step.

What is a document fraud detection API? A document in, evidence out

It is a service call that accepts a claim document and its context and returns a judgement with reasons. The context matters as much as the file. A storage invoice can only be tested against the dates the car was towed and released; a repair invoice against the approved estimate; a medical bill against the dates of service the claim allows. An API that takes only the file can test the file. One that also reads the claim can test whether the document fits the loss it is supposed to support.

The output matters more. A bare score between 0 and 1 tells the adjuster nothing she can check and gives the SIU nothing it can cite. The solution returns findings a person can verify on the page: "stroke 2.3 px, every other figure 1.7 px", "lines add to $4,812.60", "EIN on another business's paid invoice". Every finding carries its test, its level, its measurement and its location, and the verdict follows from fixed rules: any refer-level finding gives refer, question-level findings alone give question, none gives pass.

Where should document checks run in a claim? Before the money moves, as early as possible

Document checks belong at intake, because every regulated claim clock is already running. Florida's personal injury protection statute shows how little room there is. Where an insurer has a reasonable belief of fraud it must notify the claimant in writing within 30 days of the claim; then "the insurer has an additional 60 days to conduct its fraud investigation", and by day 90 it must pay or deny, with interest from the day the claim was submitted (§ 627.736(4)(i)). California allows 40 days to accept or deny a claim, extended to 80 where specific information supports a suspected fraudulent claim (10 CCR § 2695.7).

A Florida PIP fraud clock, and where a check at intake sits on it

Statutory clock, from submission90 days
Notice of fraud investigation duedays 1 to 30
Additional investigation perioddays 31 to 90
  • Notice of fraud investigation duedays 1 to 30
  • Additional investigation perioddays 31 to 90
Checked at intaketested on day 1
Tested in 41 seconds; every day left for people to investigate90 days
  • Tested in 41 seconds; every day left for people to investigate90 days
Checked in a month-end batchtested on day 30
Waiting for the batch runup to 30 days
Left to investigate60 days
  • Waiting for the batch runup to 30 days
  • Left to investigate60 days
Fla. Stat. § 627.736(4)(i). The 41 seconds is the sample invoice in Document Fraud Detection; the batch lane illustrates the timing, it is not a measured case. A check that waits for a month-end run spends a third of the clock before anyone knows there is a question.Source: Fla. Stat. § 627.736(4)(i)

A test at intake also keeps the insurer out of the position the GAO calls pay-and-chase. Its fraud framework, written for federal programs, prefers automated control activities "because they are less susceptible to human error and are typically more efficient" than manual ones such as document reviews (GAO-15-593SP). The point for an architect is placement: automation that runs on every document before payment, with people deciding on the exceptions.

Can document fraud detection integrate with claims systems? What it reads, what it writes, what stays

Yes, and the cleanest integration is narrow. The service reads from the systems that already hold the facts, writes back a verdict and evidence, and leaves payment, reserves and the claim file of record where they are. In the solution, the read side is six sources and the write side is four items.

The integration map: six sources read, four items written back, four decisions left alone

It reads

Claim intakeClaim portal, email, vendor uploads and bill feeds: invoices, medical bills, estimates and receipts, as PDF or photo.
Claim systemDates, parties, vehicle, loss and approved amounts, read to test the document against the claim.
Vendor and provider registerNames, tax IDs, NPIs, registrations and addresses.
State registration lookupWhether a contractor is registered under the name on the invoice.
Regional price listUnit prices for mitigation, repair, towing, glass and medical services.
Past claim documentsEvery invoice, bill and receipt already received, searched for the same template and identifiers.

It writes back

VerdictPass, question or refer, from fixed rules.
FindingsEach with its test, level, measurement and place on the page.
Draft note or referralEvery sentence cited to a finding, waiting for a signature.
Fingerprint and versionThe original’s SHA-256 hash and the rules version that judged it.

It never touches

Payment authority and holds
Reserves and the claim file of record
Who is contacted, and when
The referral decision and the report to the state

These stay in the claim system and with named people: the adjuster, the SIU and the fraud manager.

Sources and outputs as listed for Document Fraud Detection. Nothing listed under “It never touches” moves into the service.

The lookups show the integration in action. On the sample Clearwater invoice, the vendor check ran six lookups at 08:12: the carrier's vendor register, the state contractor registration, the tax ID across all claim documents, an address and PO box search, a phone number lookup and the insured and loss address against the claim. Each result came back as a line an adjuster can read.

Six lookups at intake, each one an integration

The Vendor check screen for Clearwater Dry-Out & Restoration LLC. What the document says against the register and lookups: name not on the vendor register; registration claimed in the footer, no state contractor registration under this name; EIN 84-3301927 on a Northfork Emergency Services LLC invoice on claim HO-26-26390; address Unit 4 is a mailbox store and remit-to PO Box 4471 is on 3 other invoices; phone a prepaid mobile activated June 2026; insured matches the claim; work dates inside the claim window. Lookups run at 08:12: Larkspur vendor register no match, state contractor registration no match, tax ID across all claim documents 1 other name, address and PO box search mailbox store 3 hits, phone number lookup prepaid line, insured and loss address match. A note says claims are linked on shared identifiers and template traits, never on a name alone.
Fictional sample vendor and claim. The matches are listed beside the misses: the insured and the work dates fit the claim.

What does a document fraud API return?

It should return enough for a person to decide and for an investigator to rely on later. That means the verdict, every finding with its measurement and location, the rules version applied, and proof that the document judged is the document received. The last item is easy to overlook and hard to add afterwards. Courts already treat a hash as that proof. The committee note to the 2017 amendment of the Federal Rules of Evidence explains: "If the hash values for the original and copy are the same, it is highly improbable that the original and copy are not identical." (FRE 902).

What Document Fraud Detection returns for each document, and why

FieldExample from the sampleWho uses it
VerdictRefer: 3 refer-level and 3 question-level findingsAdjuster: decides pay, hold, ask or refer
FindingInk weight, refer: total stroke 2.3 px, every other figure 1.7 px, at the total boxAdjuster puts the lens on it; SIU cites it
FindingEdit history, question: saved again Oct 11 21:47, ten hours before uploadSIU: lays it against the claim timeline
Look-alikes4 unrelated claims, same template, layout 0.98 to 0.99SIU: one case for five claims
DraftReferral with every sentence cited to a pinAdjuster signs; SIU accepts or declines
FingerprintSHA-256 of the original as receivedAnyone who later needs to show the copy matches
Rules versionVersion 2.3 of 5 OctoberFraud manager and examiners: which rules judged it
Fictional sample invoice 20931. Field names are descriptive; the solution's interface shows the same content on screen.

What it should not return is a silent block. In the solution an agent never holds a payment: the verdict asks a person to look, and only the adjuster's hold stops the money. That keeps the insurer's claim-handling obligations with people who can be accountable for them, and it keeps a false finding from doing more than asking a question.

Does document fraud detection slow down payment?

Not for documents that pass, which is most of them. In the sample morning the agents tested 186 claim documents in an average of 38 seconds each; 171 passed and were released for payment without anyone touching them, 12 raised a question and 3 were refer-level. Only those 15 waited for a person, and the person had the findings in front of her rather than a hunch.

A morning's verdicts: most pass in seconds, a few wait for a person

Documents tested today: 186 since 06:00, average 38 s per document; tested-today bar with 171 pass, 12 question, 3 refer; refer 3 with $14,749.39 held; question 12, ask before paying; pass 171 released for payment. The table lists each document with time received, claim, adjuster, amount, findings, verdict and test time, from 22 to 44 seconds.
Fictional sample carrier. Per-document test time ranged from 22 to 44 seconds on the rows shown.

The setting that controls the trade-off belongs to the fraud manager, not the integrator. In the sample, any claim document over $1,000 is tested, medical bills over $500, and every document on a claim already flagged. Lowering a threshold tests more documents and holds none of them by itself; it can only add questions for people to answer.

What file types can document fraud detection read?

The solution reads invoices, medical bills, estimates, receipts and tow and storage tickets as PDF or as photos and scans. The tests that apply depend on the format. A born-digital PDF carries structure: revisions, fonts and text layers that file forensics can read. A photographed receipt carries pixels, compression and camera data, where alignment, stroke weight and re-encoded regions are the evidence. A scan of a printout carries neither history nor much metadata, so the consistency checks do the work. How each kind of trace is read by hand is set out in how to check if a PDF has been altered.

Whatever the format, the document reader places every field with its position on the page, so each finding can be pinned where it is, and low-confidence fields go to a person rather than being guessed. On the sample repair invoice, the reader placed 51 values, and the passed checks are listed beside the two findings: the shop has been on the register since 2019, the arithmetic and tax hold, the VIN matches the policy vehicle, and the file was not edited after export.

A question, not a refer: two findings, four checks passed

The Delmont Collision Center repair invoice for $2,789.53 on a personal auto claim, uploaded by the repairer, tested in 29 s. Verdict Question, 2 findings. The Ink weight lens shows the body labour line, +7.5 HR, set in 9.5 pt among 9 pt. Finding 2: hours above the approved estimate, +2.0 h at $64.00, $128.00. Passed: shop on the register since 2019, arithmetic and tax hold, VIN matches the policy vehicle, file not edited after export. How the agents tested it: six agents in 29 s. Buttons: Hold payment, Ask vendor, Pay with a reason, Refer to SIU.
Fictional sample claim PA-26-58210. Paying with an open question records the reason on the claim file.

Security and data: the API is a third-party provider in your security program

Claim documents carry names, addresses, policy numbers and, on medical bills, health information, so any external service that receives them sits inside the insurer's information security program. The NAIC's Insurance Data Security Model Law says so directly: an insurer must take due care in choosing such a provider, and must require that provider to protect the systems and nonpublic information it holds (Model #668). As of the NAIC's August 2025 brief, 28 jurisdictions had implemented the model (NAIC); states that have not may have their own rules.

Three practical demands follow. Documents should be tested where the insurer's controls apply, not uploaded to a public website. Every incoming file is untrusted input and should be opened in isolation, a point covered in PDF forensics tools. And the service should keep the original unchanged, fingerprinted, and available to the insurer as evidence, rather than holding the only copy.

The detection itself is also something regulators ask about. The NAIC's antifraud plan guideline asks each plan to describe the technology and procedures the insurer uses to spot suspected fraud (GL-1690). Where a state has adopted the NAIC's AI model bulletin, 29 jurisdictions as of 8 October 2026 (NAIC map), fraud detection is one of the uses it names; governance of those systems is covered in AI Governance and Model Inventory. A service that versions its rules and records which version judged each document makes both answers easier to give.

How long does it take to integrate document fraud detection? Start without integrating

The fastest path is to test before you connect anything. A batch of past paid and open documents, exported once, shows what the tests find on your own mix and costs no integration work. Botminds runs Document Fraud Detection on a sample of the carrier's own documents first for exactly that reason. Connecting live intake comes after the carrier has seen what the findings look like and set its thresholds.

An integration order that puts evidence before plumbing

  1. Batch test on past documents

    Export a sample of paid and open documents with claim context. No live connection; findings reviewed by the SIU.

  2. Read-only registers

    Connect the vendor and provider register, price list and registration lookups. They raise the share of findings a person can act on.

  3. Shadow intake

    Test live documents as they arrive, but show the verdicts to a small team only. Measure questions raised and cleared.

  4. Write-back of verdict and note

    Put the verdict and the drafted note into the claim, still with no automated hold.

  5. Live, with people holding

    Adjusters act on questions and refers; the fraud manager owns thresholds and the second approval.

  6. Past-document search

    Index past claim documents for the look-alike search; the bigger the archive, the more templates it can match.

A sequence, not a schedule: the time each step takes depends on your claim and document systems.

Questions to put to any document fraud detection API

Ask what a person can see and check, what happens to the original, and what the service is allowed to do on its own. The answers separate a service that adds evidence to a claim from one that adds a score nobody can explain.

Eight questions for the vendor's technical team

  1. Does every finding come with a measurement and a place on the page?

    A score alone cannot be checked by the adjuster or cited by the SIU.

  2. Does it read the claim, or only the file?

    Dates, parties, approved amounts and vehicle catch what file tests cannot.

  3. Can it search our past claim documents?

    Template reuse across claims is invisible one document at a time.

  4. What does it do on its own?

    It should never hold a payment, contact a vendor or insured, or refer a claim.

  5. Is the original kept unchanged, with a hash we hold?

    Evidence the insurer cannot produce is not the insurer’s evidence.

  6. Are the rules versioned and dated?

    Examiners will ask which rules applied to which document.

  7. Where are documents processed, and under whose controls?

    Model #668 makes provider due diligence the insurer’s job.

  8. Can we run it on our own past documents before we connect?

    If not, you are buying on someone else’s test set.

Questions people ask

How does a document fraud API work?

The claims system sends a document with its claim context; the service reads the fields, tests the file, recomputes the sums, looks up the vendor and searches past documents, then returns a verdict with its findings. In the sample, the whole run took 41 seconds for one invoice.

Can document fraud detection work in real time?

Yes, for a single document at intake: the sample averaged 38 seconds per document across 186 documents in a morning. Searching a large archive of past documents takes most of that time, and is the step that finds templates reused across claims.

Do we need to replace our claims system?

No. The service reads from the claims system and registers and writes back a verdict, findings and a drafted note; payment, reserves and the claim file of record stay where they are.

What happens when the API is unsure?

Fields read with low confidence go to a person instead of being guessed, and findings from the file alone raise a question rather than a refer. A question asks the adjuster to look; it never holds a payment by itself.

Is a document fraud API a vendor under insurance data-security law?

Usually yes: a service that processes claim documents holds nonpublic information on the insurer's behalf, which the NAIC's model law treats as a third-party service provider requiring due diligence and security requirements. Check your state's version of the law.

Document Fraud Detection.
See it on your own files.

An agentic solution from Botminds. Drop in an invoice, bill, estimate or receipt; see what was changed, what does not add up, and what does not match its own source. Book a demo, or explore how it works.