Integration Overview

Introduction to integrating via Email, Webhooks and API

Integration Methods

DocVision offers three ways to integrate with your documents:

API Overview

The API provides three endpoints for document management:

1. Upload Document

POST /api/webhook/{webhookId}/document/upload

Upload documents via URL (recommended), multipart form data, or base64.

Show example
curl -X POST https://app.doc-vision.com/api/webhook/{webhookId}/document/upload \
  -H "Authorization: {your-webhook-secret}" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/documents/invoice.pdf"
  }'

View full documentation →

2. Get Document

POST /api/webhook/{webhookId}/document/get

Retrieve document status and extracted data by document ID.

Show example
curl -X POST https://app.doc-vision.com/api/webhook/{webhookId}/document/get \
  -H "Authorization: {your-webhook-secret}" \
  -H "Content-Type: application/json" \
  -d '{
    "docId": "doc_abc123xyz"
  }'

View full documentation →

3. Delete Document

POST /api/webhook/{webhookId}/document/delete

Permanently delete a document and all associated data.

Show example
curl -X POST https://app.doc-vision.com/api/webhook/{webhookId}/document/delete \
  -H "Authorization: {your-webhook-secret}" \
  -H "Content-Type: application/json" \
  -d '{
    "docId": "doc_abc123xyz"
  }'

View full documentation →

Authentication

Best Practices

  • Use URL uploads (recommended) for better reliability
  • Poll the get endpoint to check document status until extraction completes
  • Set up webhook callbacks to avoid polling