Sexual offences certificate (LOPIVI)

If people in your organisation work with minors (coaches, instructors, volunteers), Spanish law (LOPIVI) requires you to ask them for the clearance certificate from the Central Sex Offender Registry (Registro Central de Delincuentes Sexuales). With the es_sexual_offences_certificate type Constaia checks that it is that certificate, that it belongs to that person, that it is not old and that it states there are no records.

This is especially sensitive data, so this guide processes it without storing anything at Constaia.

OptionsCopy Anchor Link

{
  "expect": "es_sexual_offences_certificate",
  "checks": {
    "max_age_days": 90,
    "holder": { "full_name": "María García López", "document_number": "12345678Z" }
  },
  "storage": "none",
  "keep_results": false,
  "metadata": { "volunteer_id": "311" }
}

The has_records reason is always added, without asking:

The verification code (CSV)Copy Anchor Link

These certificates carry a secure verification code (CSV, "código seguro de verificación"). Constaia extracts it in csv_code and runs the csv_format validation.

If the format is invalid, checks[] contains csv_format with passed: false and the verdict becomes invalid with a csv_format reason of severity error.

The PDF's electronic signatureCopy Anchor Link

The certificate downloaded from the Ministry of Justice's e-government site is a PDF with an electronic signature (the Ministry's seal). Constaia verifies it at no extra cost and without contacting anyone: that the content hasn't been touched since it was signed and that the signer's certificate chains to a trusted authority. The result goes in signature and in verdict.reasons:

If you only accept the original PDF, add "require_valid_signature": true to checks: a photo or a "print to PDF" becomes invalid and the person knows they must upload the downloaded file. If you accept photos, leave it off and review the review cases by hand. Also compare signature.signer with the expected body: a valid signature only proves who signed. Details and limits in Digital signatures in PDF.

The codeCopy Anchor Link

import { Constaia, ConstaiaError } from "@constaia/sdk";
import { fromPath } from "@constaia/sdk/node";

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

export async function checkSexualOffencesCertificate(path, person) {
  const analysis = await constaia.analyze(await fromPath(path), {
    expect: "es_sexual_offences_certificate",
    checks: {
      maxAgeDays: 90,
      holder: { fullName: person.fullName, documentNumber: person.documentNumber },
    },
    storage: "none",
    keepResults: false,
    language: "en",
    metadata: { volunteer_id: String(person.id) },
  });

  return {
    analysisId: analysis.id,
    checkedAt: analysis.completed_at,
    status: analysis.verdict?.status ?? "review",
    problems: (analysis.verdict?.reasons ?? [])
      .filter((r) => r.severity !== "info")
      .map((r) => r.message),
  };
}

try {
  const result = await checkSexualOffencesCertificate("./sexual_offences_certificate.pdf", {
    id: 311,
    fullName: "María García López",
    documentNumber: "12345678Z",
  });
  console.log(result);
} catch (err) {
  if (err instanceof ConstaiaError) console.error(err.code, err.message, err.requestId);
  else throw err;
}

What it returnsCopy Anchor Link

With the test file sexual_offences_certificate.pdf and the options of the curl example (messages in Spanish, the default language), if the PDF is the signed original (otherwise you'll also see signature_missing with warning and a review verdict; see Test it):

{
  "expected": ["es_sexual_offences_certificate"],
  "match": true,
  "status": "valid",
  "reasons": [
    { "code": "type_match", "severity": "info", "message": "El documento es Certificado de delitos de naturaleza sexual." },
    { "code": "max_age_days", "severity": "info", "message": "Emitido hace 14 días (máximo 90)." },
    { "code": "holder", "severity": "info", "message": "Los datos del titular coinciden (full_name)." },
    { "code": "has_records", "severity": "info", "message": "El certificado indica que no constan antecedentes." }
  ]
}

And in checks[]: nif_check_digit (the holder's DNI check letter, 12345678Z) and csv_format with passed: true. The fields are holder_name (MARÍA GARCÍA LÓPEZ), holder_id (12345678Z), issue_date (2026-09-15), has_records (false) and csv_code (MJU4-7K2P-9QXA-3ZTR). The number of days depends on the date you run it.

What to store in your systemCopy Anchor Link

Since Constaia keeps nothing (keep_results: false), your record is the only trace. Store the minimum:

Don't keep the PDF or the other fields unless you need them. If you keep csv_code to verify it later at the electronic office, treat it as sensitive data: it can be used to locate the certificate.

DecideCopy Anchor Link

For review you need your own copy of the document, because with storage: "none" Constaia doesn't keep it. See Human review.

Test itCopy Anchor Link

With a ck_test_… key, a PDF named sexual_offences_certificate.pdf (or any name containing sexual, delitos or penales) returns the no-records certificate of MARÍA GARCÍA LÓPEZ issued on 2026-09-15. Change holder.full_name to see invalid, or lower max_age_days to 7 to see the max_age_days reason with error. More in Test mode.

The signature is not simulated: with any unsigned PDF you'll get signature_missing (warning) and a review verdict. Use a JPEG or PNG image with that name to see the valid in the table, or your own certificate downloaded from the e-government site to see signature_valid.

Next stepsCopy Anchor Link