Documents

POST /api/v1/documents

Upload d'un PDF. Le hash SHA-256 est calculé côté serveur et retourné dans la réponse — il sert ensuite d'identité d'intégrité du document tout au long du cycle de vie de la signature.

Headers

Body

Tout fichier non-PDF est rejeté avec un 422 validation_error (message localisé indiquant le type MIME invalide).

Exemple

curl https://app.signlift.eu/api/v1/documents \
  -H "X-Api-Key: $SIGNLIFT_API_KEY" \
  -F "file=@contract.pdf"

Réponse 201

{
  "id": 42,
  "content_type": "pdf",
  "sha256_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "file_size": 154823,
  "status": "ready",
  "created_at": "2026-05-17T15:00:00Z"
}

• status : ready une fois le fichier accessible côté Signlift.
• La réponse de création ne contient pas d'URL de téléchargement — utilisez le GET ci-dessous pour obtenir une URL S3 présignée.

GET /api/v1/documents

Liste paginée des documents téléversés. Utile pour retrouver un document dont vous n'avez pas conservé l'identifiant, ou pour vérifier ce qui est réellement disponible avant de construire une demande de signature.

Enveloppe, pagination et filtres : voir Collections paginées. Le filtre status accepte pending et ready.

Exemple

curl "https://app.signlift.eu/api/v1/documents?status=ready&order=desc&limit=50" \
  -H "X-Api-Key: $SIGNLIFT_API_KEY"

Réponse 200

{
  "data": [
    {
      "id": 42,
      "content_type": "pdf",
      "sha256_hash": "9f86d081...",
      "file_size": 154823,
      "status": "ready",
      "created_at": "2026-05-17T15:00:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "count": 1, "pages": 1 }
}

La liste ne rend que les documents de l'environnement de votre clé. Un document téléversé depuis l'interface web n'est visible que d'une clé de production : il n'est pas filigrané, contrairement à un document sandbox.

GET /api/v1/documents/{id}

Récupère les métadonnées d'un document précédemment uploadé et une URL S3 présignée pour télécharger le PDF original.

Réponse 200

{
  "id": 42,
  "content_type": "pdf",
  "sha256_hash": "9f86d081...",
  "file_size": 154823,
  "status": "ready",
  "created_at": "2026-05-17T15:00:00Z",
  "download_url": "https://s3.eu-west-1.amazonaws.com/...?X-Amz-Signature=..."
}

• download_url : URL S3 présignée pointant sur le PDF original (non signé). Valide pendant 15 minutes — rappelez l'endpoint pour en obtenir une nouvelle si nécessaire. Pour récupérer le PDF signé après complétion, voir Signature Requests — download_urls.