API Documentation

Quickstart

Get up and running in 3 steps.

1. 1. Create an account

   Sign up at validoc.tech/sign-up and grab your API key in Settings.

2. 2. Validate a document (inline rules)

   No setup needed — pass rules directly in the request.

   curl -X POST https://validoc.tech/api/v1/validate \
     -H "Authorization: Bearer dv_your_api_key" \
     -F "file=@invoice.pdf" \
     -F 'rules=["Signature is present", "Invoice number", "No visible alterations"]'

3. 3. Or use a reusable ruleset

   Create a ruleset + rules once, then reference it by ID.

   # Create ruleset
   curl -X POST https://validoc.tech/api/v1/rulesets \
     -H "Authorization: Bearer dv_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{"name": "Invoice Check"}'
   
   # Add a rule
   curl -X POST https://validoc.tech/api/v1/rulesets/rs_abc123/rules \
     -H "Authorization: Bearer dv_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{"prompt": "Signature is present"}'
   
   # Validate
   curl -X POST https://validoc.tech/api/v1/validate \
     -H "Authorization: Bearer dv_your_api_key" \
     -F "file=@document.pdf" \
     -F "ruleset_id=rs_abc123"

Authentication

All requests must include an Authorization header with a Bearer token.

Authorization: Bearer dv_xxxxxxxxxx

• API keys are created and managed in Settings.
• All keys start with the dv_ prefix.
• Requests without a valid key return HTTP 401.

POST /api/v1/validate

Validate a PDF document against rules. Provide rules inline or reference a saved ruleset.

Request

Content-Type: multipart/form-data

Response

{
  "id": "val_01j9xz4k8m",
  "status": "pass",
  "score": 1.0,
  "results": [
    {
      "rule": "Signature is present",
      "passed": true,
      "value": null,
      "explanation": "Digital signature found on page 2",
      "confidence": 0.98
    },
    {
      "rule": "Invoice number",
      "passed": true,
      "value": "INV-2024-0042",
      "explanation": "Invoice number found in header",
      "confidence": 0.95
    }
  ]
}

Response fields

Rulesets

A ruleset is a named collection of rules. Create one per document type (invoices, contracts, IDs, etc.).

curl -X POST https://validoc.tech/api/v1/rulesets \
  -H "Authorization: Bearer dv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Invoice Check",
    "description": "Validates standard invoice fields"
  }'

curl https://validoc.tech/api/v1/rulesets \
  -H "Authorization: Bearer dv_your_api_key"

Rules

Rules belong to a ruleset. Each rule is a natural-language prompt that the AI evaluates against the document.

curl -X POST https://validoc.tech/api/v1/rulesets/rs_abc123/rules \
  -H "Authorization: Bearer dv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Signature is present"}'

Concepts