Vérification — référence de l’API v1

Retrouver la preuve d’un PDF par empreinte, même après purge. Référence générée depuis les schémas de validation de l’API : ce que vous lisez est ce que le serveur vérifie.

post/verify — Vérifier un document par empreinte

Base : https://preprod-app.signatik.com/api/v1 · authentification Authorization: Bearer sk_… · erreurs { "error": { "code", "message" } }.

post/api/v1/verify

Vérifier un document par empreinte

Soumettez le PDF (base64) ou son empreinte SHA-256. Retrouve l’enveloppe (document original, scellé ou révision intermédiaire), renvoie signataires, chronologie chaînée et chain_valid. Fonctionne même après purge des documents. Scope envelopes:read.

●POST /verify

curl -X POST https://preprod-app.signatik.com/api/v1/verify \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
  "pdf_base64": "JVBERi0…",
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}'

●200 — exemple de réponse

{
  "known": true,
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "matches": "original_document",
  "document": {
    "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
    "name": "Contrat de mission n°1234",
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "sealed_sha256": "…",
    "current_sha256": "…"
  },
  "envelope": {
    "id": "8f2c1d4e-0b7a-4c1e-9f0d-6a3b2c1d0e9f",
    "name": "Contrat de mission n°1234",
    "status": "…",
    "signature_level": "…",
    "pades_level": "…",
    "completed_at": "2026-09-02T14:33:07Z",
    "sealed_at": "2026-09-02T14:33:07Z",
    "documents_available": true
  },
  "signers": [
    {}
  ],
  "events": [
    {
      "type": "…",
      "actor": "…",
      "at": "…",
      "hash": "…",
      "prev_hash": "…"
    }
  ],
  "chain_valid": true,
  "proof": {}
}

Corps de la requête

Champ	Type	Description
`pdf_base64`	string
`sha256`	string

Réponses

`200`	`known: false` si l’empreinte est inconnue de votre organisation
`400`	Ni PDF ni empreinte
`401`	Clé absente, mal formée ou révoquée (`unauthorized`)
`403`	Scope manquant sur la clé (`forbidden`)
`429`	Limitation de débit (`rate_limited`, en-tête `Retry-After`)

Réponse 200

Champ	Type	Description
`known`requis	boolean
`sha256`requis	string
`matches`	"original_document" \| "sealed_document" \| "signed_revision"
`document`	object
`id`requis	uuid
`name`requis	string
`sha256`requis	string
`sealed_sha256`requis	string \| null
`current_sha256`requis	string \| null
`envelope`	object
`id`requis	uuid
`name`requis	string
`status`requis	string
`signature_level`requis	string
`pades_level`requis	string \| null
`completed_at`requis	date-time \| null
`sealed_at`requis	date-time \| null
`documents_available`requis	boolean
`signers`	object[]
`events`	object[]	Chronologie chaînée par empreinte
`type`requis	string
`actor`requis	string
`at`requis	string
`hash`requis	string
`prev_hash`requis	string \| null
`chain_valid`	boolean
`proof`	object	Signature avancée : horodatages, mandat, chaîne de confiance