Skip to content

Fileverity API

Detect AI generation and tampering in images, documents and text, from your code or your browser.

For teams in claims, lending, HR and online platforms. Each image or document check returns a full evidence report with a risk level, a recommended action and a record anyone can verify; each text check returns a scored result. Use it in your browser or from your own software.

Start freeRead the docs

Free start: 5 image or document checks and 5,000 text characters. No card, no subscription.

At a glance

Base URL
https://api.fileverity.com/v1
Authentication
Bearer API key, live or test
Format
JSON over HTTPS
Rate limit
120 requests per minute per key
Images and documents
Upload the file, then start the check. Get the result with Prefer: wait or a webhook.

Two ways to use it

The same checks, in your browser or in your code.

Both use one workspace, one prepaid balance and the same reports. Choose by who is doing the work.

In your browser

Console

Sign in with your Fileverity login, add funds and check files without writing code.

  • Check images and documents, or paste text
  • See past checks, your balance and invoices
  • Create API keys when your team is ready

In your code

API

Send files and text to api.fileverity.com and get structured results back.

  • Bearer keys for live and test mode
  • Text results in the same response; file results by waiting or by webhook
  • An OpenAPI 3.1 specification

Where teams use it

Put a check in front of every file decision.

What you can check

Images, documents and text.

Each check returns structured JSON. Image and document checks return the same report as the website; text checks return a result.

Choose the check

Pick the check that matches your file.

Images and documents take two calls and return a full report. Text takes one call and returns a result. One key and one balance cover all three.

Image, document and text checks compared by model, input, output, price, endpoint and response mode
CheckModel IDYou sendYou get backPriceEndpointResult arrives
Image checkfvimg-2A JPEG, PNG or WebP imageA full report with findings, marked regions and a report IDUS$1.99 per imagePOST /v1/files, POST /v1/analysesWait for it or use a webhook
Document checkfvdoc-3A PDF, Word or other document fileA full report with findings, flagged passages and a report IDUS$5.99 per documentPOST /v1/files, POST /v1/analysesWait for it or use a webhook
Text checkfvdoc-3-textPlain text of at least 100 wordsA result with a verdict, a score and the AI-written passagesUS$0.14 per 1,000 charactersPOST /v1/text/detectionsIn the same response
  • FVIMG V2

    Images

    fvimg-2POST /v1/files, POST /v1/analyses

    Checks for AI generation and local edits, and reads watermarks, Content Credentials and AI labels.

    Returns

    • Findings by evidence category
    • Marked regions and likely generator where supported
    • Report ID, fingerprints, timestamp and verification page
  • FVDOC V3

    Documents

    fvdoc-3POST /v1/files, POST /v1/analyses

    Checks PDF and Word files for alterations, inconsistencies, AI-written text, embedded photos and file history.

    Returns

    • Findings across text, photos and file records
    • Flagged passages with their pages
    • Report ID, fingerprints, timestamp and verification page
  • FVDOC V3 Text

    Text

    fvdoc-3-textPOST /v1/text/detections

    Classifies plain text as AI-written, mixed or human-written and marks the AI-written passages.

    Returns

    • A verdict: ai, mixed or human
    • A score and the AI-written share of the text
    • Passages as character offsets

What you get

A report you can act on, not a score.

Every image and document check returns the full report: a risk level, the evidence behind it, a recommended next step and a record anyone can verify.

Image reportSpecimenFV-7K2M-9Q4X-RT8N
Assessment
Photo with local alterations
Risk level
L4Highly suspicious
Recommended action
Review manually before relying on the image

Key evidence

  1. E1R1: edited region, moderate signal
  2. E2Compression history: anomaly found
  3. E3No Content Credentials in the file
Report data hash
sha256:3f9a7c1e…b8d4e21c
Trusted timestamp
DigiCert · RFC 3161
fileverity.com/verify
Document reportSpecimenFV-3H8D-K2QW-6NZC
Finding
Parts show AI-writing signals
Flagged passages
  • P1page 3, paragraph 3
  • P2page 3, paragraph 4
Recommended next step
Review the flagged passages. Ask the submitter how the document was drafted and request the original digital file.

File observations

  1. E1Creating software recorded in the file
  2. E2No AI label or Content Credentials found
  3. E3No hidden or look-alike characters
Report data hash
sha256:a41d09e7…5c2f80b3
Trusted timestamp
DigiCert · RFC 3161
fileverity.com/verify

Text checks return a result instead: a verdict, a score and the passages that look AI-written.

Pricing

Pay for each check.

Top up any amount from US$19 and spend it on any mix of image, document and text checks. One payment, no subscription, nothing renews.

API and Console prices
CheckPrice
Image checkBilled per imageUS$1.99
Document checkBilled per documentUS$5.99
Text checkBilled per 1,000 charactersUS$0.14

Text is rounded up to the next 1,000 characters for each request. Text checks need at least 100 words.

Free start

Try it before you add funds.

Your first workspace starts with 5 free image or document checks and 5,000 free text characters.

No card is needed to start. One free start per person, and a limited number per company email domain. Teammates should join through an invitation.

How billing works

  1. 01 / 03

    Add funds

    Top up your workspace balance by card with any amount from US$19. It is a single payment, not a subscription.

  2. 02 / 03

    Run checks

    Each completed check deducts its listed price. Everyone in the workspace uses the same funds in the Console and through the API. Failed checks are free.

  3. 03 / 03

    See your invoices

    Every top-up comes with a Stripe invoice in the Console, and business customers can add a tax ID at checkout.

Prices are in US dollars. Stripe calculates any applicable tax at checkout. Failed checks are not charged.

Spend control

Stay in control of what you spend.

You always see what you have spent. Nothing renews and nothing is charged in the background.

  • Low-balance alerts

    On by default. Workspace owners and admins get an email before funds run out.

  • Auto-recharge

    Optional. Top up from a saved card when the balance falls below a level you set.

  • Spend limit per key

    Set a monthly spend limit on each API key, so one integration cannot use the whole balance.

Security and data handling

Files are deleted and text is not stored.

The API follows the same data practices as the website.

  • Uploaded files are deleted after analysis and are never used to train models
  • Submitted text is not stored
  • Results are kept for 7 days, so you can fetch them again
  • Keys are created and revoked in the Console, and request logs show how each key was used
  • Webhooks are signed and follow the Standard Webhooks specification
  • A data processing agreement is available on request

Built for traceability

Every image and document result can be checked later.

Image and document results carry the same evidence record as reports on the website.

  • Report ID

    Store the report ID next to your own case or customer record.

  • Fingerprints and timestamp

    SHA-256 fingerprints and an RFC 3161 timestamp are recorded with each report.

  • Public verification page

    Anyone you share the report ID with can confirm it on the verification page, without an account.

  • OpenAPI 3.1

    The API is described by a published OpenAPI document, so you can generate clients and validate responses.

For developers

Build against test keys first.

Keys are bearer tokens that you create in the Console. Keep them on your server.

Authorization: Bearer fv_test_…
  • fv_test_…

    Returns fixed sample results and is never charged. Use it while you build and in your automated tests.

  • fv_live_…

    Runs checks and deducts the price from your workspace balance.

  • Send the key in the Authorization header as a bearer token
  • Test and live keys call the same endpoints
  • Revoke a key in the Console at any time

Frequently asked questions

Do I need to write code to use it?

No. The Console lets you add funds and run image, document and text checks in the browser, with the same login as the website. The API is for sending checks from your own systems.

Can I try it without paying?

Yes. Your first workspace starts with 5 free image or document checks and 5,000 free text characters, and no card is needed. There is one free start per person and a limited number per company email domain, so invite teammates to your workspace instead of signing up separately. Test keys return fixed sample results and are never charged, so you can build the integration first.

How accurate are the results?

Results are evidence for a human review, not a verdict. Every report states how strong the evidence is, what could not be examined and what to do next. The accuracy guides linked under these questions explain how to read results and where false positives come from.

Is this the same balance as the credits on the website?

No. The workspace balance used by the Console and the API is separate from the credits you buy on the website. Credits apply only to reports you run on fileverity.com.

Do I get invoices, and can I add a tax ID?

Yes. Every top-up comes with an invoice, and business customers can add a tax ID at checkout. Stripe calculates any applicable tax from your billing address.

How do I avoid running out of balance?

Low-balance alerts are on by default and email your workspace owners and admins. Turn on auto-recharge to top up from a saved card, and set a monthly spend limit on each API key.

What happens if a check fails or my balance runs out?

A check that fails is not charged. When the balance cannot cover a check, the request returns insufficient_balance and nothing is charged until you add funds.

Does the workspace balance expire, and can I get a refund?

The balance stays valid for 12 months after your latest top-up, and every top-up extends the whole balance. Top-ups are non-refundable except where required by law or stated in your agreement.

Are results returned in the same request?

Text results come back in the response. Image and document checks take two steps: upload the file, then start the check. Send Prefer: wait to receive the result in the same request, or use a webhook to be notified when it is ready.

What does a text check accept?

Plain text in English, French, German, Spanish or Chinese, from 100 words up to 100,000 characters per request. The language is detected automatically if you do not set it.

How long are files and results kept?

Uploaded files are deleted after analysis, submitted text is not stored, and results are kept for 7 days.

Do you offer a data processing agreement?

Yes. A data processing agreement is available on request and is included with Enterprise.

When do I need Enterprise?

When you want volume pricing, a private on-premises or fully offline deployment, or a custom integration. Everything else is self-serve.

Enterprise

Volume pricing, private deployment, custom integration.

For high volumes and strict internal policies, our team prices to your volume, deploys Fileverity on your own servers or fully offline, and builds the integration you need.

Make your first check in minutes.

Open the Console, use your free start and send a test request. Add funds only when you are ready for live results.