Skip to content
Constaia

Next.js

Validate documents with AI in Next.js

A server route receives the file, calls Constaia with the SDK and returns the verdict. The key stays on the server.

Installation

npm i @constaia/sdk

The safe pattern

The browser or app never sees your secret key. The file goes to your server, your server calls Constaia and returns the result. If you do not have a server, use the widget with a publishable key.

Full guide
app/api/verify/route.ts
import { Constaia } from "@constaia/sdk";

const constaia = new Constaia(); // reads CONSTAIA_API_KEY

export async function POST(request: Request) {
  const form = await request.formData();
  const file = form.get("file");
  if (!(file instanceof File)) return Response.json({ error: "missing_file" }, { status: 400 });

  const analysis = await constaia.analyze(file, {
    expect: "es_dni",
    checks: { notExpired: true },
    storage: "none",
  });

  return Response.json({
    status: analysis.verdict?.status, // "valid" | "invalid" | "review"
    reasons: analysis.verdict?.reasons,
  });
}

One call. An answer you can act on.

  1. 01

    Send the document and what you expect

    A photo, screenshot or PDF. Say which document you expect and the rules: in date, less than 6 months old, in this person's name.

  2. 02

    We read, classify and check

    Text reading, AI classification and fixed checks: Spanish ID number check letter, machine readable zone, IBAN, dates and totals.

  3. 03

    Get the verdict and the file is deleted

    Valid, invalid or review, with the reasons in your language. By default, the file is deleted at the end unless it needs review.

And for the record…

Create your free account and validate your first document in five minutes. No card required.