API documentation

Files and versioning

Supported file types, API versions, and OpenAPI contract details.

Supported file types

Start with PDFs for invoice workflows. Use other formats when the source system already produces them. exdata checks file content signatures and scanner status before extraction work is queued.

  • PDFInvoices, credit notes, account statements, letters, contracts, and exported reports.
  • PNGScanned document pages and image-only uploads.
  • JPGPhotographed documents and image captures from mobile workflows.
  • HTMLSaved web documents, rendered invoice templates, and HTML exports.
  • TXTPlain-text documents and extracted text from upstream systems.
  • CSVTabular exports where the document data is already structured in rows.
  • JSONStructured source payloads that should be normalized into the same extraction response shape.
  • DOCXOffice documents such as contracts, letters, statements, and reports.
  • EMLEmail files with sender, recipient, subject, headers, and body content.
  • MSGOutlook message files for email-based document workflows.
  • XMLE-invoices and XML exports from finance or ERP systems.
  • EDIElectronic data interchange payloads used in operations and procurement workflows.
  • IDocSAP IDoc exports and integration payloads.

API versioning

Use /api/v1 for document API integrations. Breaking API changes will be introduced under a new versioned base path.

OpenAPI contract

The OpenAPI YAML is available publicly for client generation and schema review. Client collections and receiver examples are listed under Tools and downloads.

OpenAPI contract
https://www.exdata.app/docs/api/openapi.yaml

Data handling links

Review these documents before sending production customer files through the API.

  • Privacy policy for how personal data is handled.
  • DPA for controller/processor terms.
  • TOMs for technical and organizational measures.
  • Security overview for access controls, audit context, and operational safeguards.
  • Data residency for regional processing information.
  • Subprocessors for third-party processing dependencies.
  • Terms for product and account usage terms.