Quickstart

Start validating documents with the ZeroDrift API in minutes

Get started in three steps

Validate your first document using the ZeroDrift Validation API.

Step 1: Get your API key

Create an API key in Command

API keys live in ZeroDrift Command. Sign in, open Settings, then under API select Keys.

1. Select Create first key (or New API key if you already have keys).
2. In the Create API key dialog, enter a Key name, choose Permissions (Full access or Read only), and set Rulepacks.
3. Select Create, then Copy the key immediately — Command shows the full value only once.

Use the key in the x-api-key header for all API requests:

x-api-key: YOUR_API_KEY

Step 2: Submit content for validation

Validate content

The quickest way to test the API is with a text snippet:

curl -X POST "https://api.zerodrift.ai/api/v3/content/validate" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_text": "Our fund guarantees 20% returns with zero risk!",
    "document_category": "scenario_retail_investor_letter"
  }'

You’ll receive a job_id in the response:

{
  "api_version": "v3",
  "job_id": "abc123def456",
  "status": "queued",
  "mode": "async",
  "model_engine": "v2_frontier",
  "poll": { "method": "GET", "url": "/api/v3/jobs/abc123def456" }
}

Validation runs asynchronously by default. For short content you can set "mode": "sync" to receive the completed result in a single response, and "model_engine": "anchor_3_0" selects the faster Anchor 3.0 SLM — see Validate Content.

Step 3: Get validation results

Poll for results

Use the job_id to retrieve your validation results:

curl "https://api.zerodrift.ai/api/v3/jobs/abc123def456" \
  -H "x-api-key: YOUR_API_KEY"

Poll until status is done or failed. A completed response includes:

{
  "api_version": "v3",
  "job_id": "abc123def456",
  "status": "done",
  "model_engine": "v2_frontier",
  "overall_status": "do not send",
  "summary": { "do_not_send": 1, "send_with_caution": 0, "document_pages": 1 },
  "violations_by_line": [
    {
      "line_number": 1,
      "line_text": "Our fund guarantees 20% returns with zero risk!",
      "rule_count": 1,
      "rules_violated": [
        {
          "rule_name": "Prohibited Promissory Language (Keywords)",
          "rule_ref": "FINRA 2210(d)(1)(B)",
          "severity": "do_not_send",
          "confidence": 0.92,
          "action": "replace"
        }
      ],
      "best_fix": {
        "severity": "do_not_send",
        "rule_name": "Prohibited Promissory Language (Keywords)",
        "rule_ref": "FINRA 2210(d)(1)(B)",
        "action": "replace",
        "suggested_text": "Our fund has historically delivered returns, though past performance does not guarantee future results.",
        "confidence": 0.92
      }
    }
  ]
}

Next steps

Explore the full API capabilities:

Validate Content

Full request/response details for the validation endpoint used above.

API Introduction

Full API reference with authentication, workflows, and rate limits.

Rule Packs

Browse the managed and custom rule pack catalog.

Need help? Contact us at [e-mail]