SandocsEnterprise API
SANDOCS · ENTERPRISE

Secure document processing for your systems

Replace your upload button with Sandocs. Your business receives the processed image and recognized metadata as JSON.

Installation and API instructions

  1. Activate Enterprise and create an integration in your account. Select the fields to hide, processing language and allowed website origins.
  2. Save SANDOCS_PUBLIC_KEY and SANDOCS_SECRET_KEY in your backend environment. Never put the secret in browser code, a URL or a public repository.
  3. Server integration: send image bytes to POST /enterprise/api with Bearer secret, X-Sandocs-Public-Key and a random Idempotency-Key. Read the processed PNG and metadata from JSON.
  4. Website button: install the widget script and your backend token/result adapters. Authenticate applicants, check CSRF and rate-limit token issuance. The browser receives a five-minute token scoped to your origin and one request.
  5. Before accepting a browser result, your backend must verify its SHA-256 against the protected receipt endpoint and bind client_reference to the applicant who requested the token.

https://sandocs.eu/enterprise/api · OpenAPI 3.1

Ready-to-use integration code

Limits, retries and privacy

API shares your Enterprise allowance with Web: 1000 processing attempts per UTC month, two concurrent requests per account. AI is always enabled. No advertisements or watermark.

Use a new random idempotency key for a new document; keep the same key and bytes on retries. Reusing a key with different data or settings returns 409. A started AI attempt consumes one document even if the provider fails.

Photos and recognized data are not saved to Sandocs storage. Results may be replayed from memory for 60 seconds; technical idempotency records expire after 24 hours.

If a result is no longer in memory, the same request returns 409 enterprise_result_not_retained instead of processing again. Server restarts and memory pressure may end replay earlier.

Supported uploads: JPEG, PNG and WebP, up to 25 MB and 50 megapixels. Metadata contains recognized personal data; protect it in your own system. AI masks require review.

Sandocs uses the centrally configured AI provider. Provider-side retention must be disabled in the operator’s Together AI privacy settings; do not log document bodies in your infrastructure.

Single-use client upload links

Select an integration, save your company name, URL identifier and delivery email. Verify another mailbox with a code, enable the company page, then generate a link. Share it by WhatsApp, email or copy. The client uploads, reviews the processed copy and confirms sending it to your verified email.

Additional documents

Need more capacity? Add 1000 documents for €49. One-off purchase, no automatic renewal, valid until your current Enterprise access period ends.