Get Validation Results

curl --request GET \
  --url https://api.zerodrift.ai/api/v3/jobs/{job_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.zerodrift.ai/api/v3/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zerodrift.ai/api/v3/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zerodrift.ai/api/v3/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zerodrift.ai/api/v3/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "in_progress",
  "model_engine": "anchor_3_0",
  "started": "2026-06-25T12:00:00.123456+00:00",
  "timestamp": "2026-06-25T12:00:02.654321+00:00"
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "done",
  "model_engine": "anchor_3_0",
  "overall_status": "do_not_send",
  "summary": {
    "do_not_send": 1,
    "send_with_caution": 0,
    "document_pages": 1
  },
  "violating_line_count": 2,
  "compliant_line_count": 3,
  "total_line_count": 5,
  "revalidation_recommended": true,
  "relevant_rule_ids": [
    "guarantee_of_returns",
    "missing_risk_disclosure"
  ],
  "input_tokens": 119,
  "output_tokens": 1920,
  "violations_by_line": [
    {
      "line_number": 2,
      "line_text": "Our fund guarantees 18% returns with no downside risk.",
      "char_from": 45,
      "char_to": 98,
      "page": 1,
      "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
      }
    }
  ],
  "fixes": [],
  "fixes_group": {},
  "metadata": {}
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "failed",
  "model_engine": "anchor_3_0",
  "error": "Validation engine unavailable"
}

GET

api

jobs

{job_id}

Get Validation Results

curl --request GET \
  --url https://api.zerodrift.ai/api/v3/jobs/{job_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.zerodrift.ai/api/v3/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zerodrift.ai/api/v3/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zerodrift.ai/api/v3/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zerodrift.ai/api/v3/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "in_progress",
  "model_engine": "anchor_3_0",
  "started": "2026-06-25T12:00:00.123456+00:00",
  "timestamp": "2026-06-25T12:00:02.654321+00:00"
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "done",
  "model_engine": "anchor_3_0",
  "overall_status": "do_not_send",
  "summary": {
    "do_not_send": 1,
    "send_with_caution": 0,
    "document_pages": 1
  },
  "violating_line_count": 2,
  "compliant_line_count": 3,
  "total_line_count": 5,
  "revalidation_recommended": true,
  "relevant_rule_ids": [
    "guarantee_of_returns",
    "missing_risk_disclosure"
  ],
  "input_tokens": 119,
  "output_tokens": 1920,
  "violations_by_line": [
    {
      "line_number": 2,
      "line_text": "Our fund guarantees 18% returns with no downside risk.",
      "char_from": 45,
      "char_to": 98,
      "page": 1,
      "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
      }
    }
  ],
  "fixes": [],
  "fixes_group": {},
  "metadata": {}
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "failed",
  "model_engine": "anchor_3_0",
  "error": "Validation engine unavailable"
}

Retrieve the status and result of a v3 validation job started via Validate Content. Poll this endpoint until status is done or failed.

Path Parameters

string

required

The job_id returned by Validate Content.

Response

string

Always v3.

string

Unique identifier for the validation job.

string

Job status: started, in_progress, done, or failed.

string

Engine that produced the result: v2_frontier or anchor_3_0.

string

Present when an anchor_3_0 request failed and fell back to v2_frontier automatically.

string

Time when the validation job started.

string

Time when this result snapshot was generated.

string

Error details (present only when status is failed).

string

Overall compliance assessment: approved, needs_changes, or do not send. Note: do not send contains spaces — this matches the API response exactly.

object

Violation counts by severity.

Show summary properties

integer

Count of blocking severity violations

integer

Count of caution severity violations

integer

Number of pages in the document

integer

Number of lines with at least one compliance violation. Absent for older jobs or when only grouped fixes exist (per-line positions unavailable).

integer

Number of lines with no violations. Absent for older jobs or when only grouped fixes exist.

integer

Total number of lines in the document. Absent for older jobs or when only grouped fixes exist.

boolean

True when more than one fix is found, suggesting a re-scan after applying fixes.

array

Rule IDs the model identified as relevant to the content. Present for the anchor_3_0 engine (the SLM’s per-request evaluated rule set); absent for v2_frontier.

integer

Input (prompt) tokens the anchor_3_0 SLM consumed for this validation. Present for the anchor_3_0 engine; absent for v2_frontier (which tracks usage separately).

integer

Output (generated) tokens the anchor_3_0 SLM produced for this validation. Present for the anchor_3_0 engine; absent for v2_frontier.

array

One entry per violating line, with all rules violated and the best fix. Absent for older jobs or when only grouped fixes exist. Present but empty for fully compliant documents.

Show line violation properties

integer

1-indexed line number in the document

string

The text content of the violating line (trimmed)

integer

Character offset of the best fix’s original text start

integer

Character offset of the best fix’s original text end

integer

Page number where the violation appears

integer

Number of distinct rules violated on this line

array

All rules violated on this line, sorted by severity then confidence. Each entry carries rule_id (canonical rule identifier — rule-pack id, or cust_{customer_id}_{id} for activated custom rules), rule_name, rule_ref (regulatory citation, e.g. FINRA 2210(d)(1)(B)), severity (do_not_send or send_with_caution), confidence (0–1), and action (replace, insert_after, remove, or warning).

object

The recommended fix for this line (from the highest-severity, highest-confidence rule): severity, rule_id, rule_name, rule_ref, action, suggested_text (null when action is remove/warning), human_action, and confidence.

array

Individual fix entries (rule-centric, one per violation per quote). Each entry carries rule_id — the canonical rule identifier (rule-pack id, or cust_{customer_id}_{id} for activated custom rules).

object

Grouped fixes for rules that aggregate across pages. Each value additionally carries rule_id (the canonical rule identifier — also the key under which the group is stored in this object).

object

Document metadata used for scenario matching.

Status Values

Status	Description
`started`	Job created and started processing
`in_progress`	Validation in progress
`done`	Validation completed successfully
`failed`	Validation failed with error

Error Responses

Status	Description
403	Forbidden — missing, invalid, inactive, or unresolved API key
404	Job Not Found

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "in_progress",
  "model_engine": "anchor_3_0",
  "started": "2026-06-25T12:00:00.123456+00:00",
  "timestamp": "2026-06-25T12:00:02.654321+00:00"
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "done",
  "model_engine": "anchor_3_0",
  "overall_status": "do_not_send",
  "summary": {
    "do_not_send": 1,
    "send_with_caution": 0,
    "document_pages": 1
  },
  "violating_line_count": 2,
  "compliant_line_count": 3,
  "total_line_count": 5,
  "revalidation_recommended": true,
  "relevant_rule_ids": [
    "guarantee_of_returns",
    "missing_risk_disclosure"
  ],
  "input_tokens": 119,
  "output_tokens": 1920,
  "violations_by_line": [
    {
      "line_number": 2,
      "line_text": "Our fund guarantees 18% returns with no downside risk.",
      "char_from": 45,
      "char_to": 98,
      "page": 1,
      "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
      }
    }
  ],
  "fixes": [],
  "fixes_group": {},
  "metadata": {}
}

{
  "api_version": "v3",
  "job_id": "a1b2c3",
  "status": "failed",
  "model_engine": "anchor_3_0",
  "error": "Validation engine unavailable"
}

Example

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

import requests
import time

API_KEY = "YOUR_API_KEY"
API_BASE = "https://api.zerodrift.ai"

def get_results(job_id):
    while True:
        response = requests.get(
            f"{API_BASE}/api/v3/jobs/{job_id}",
            headers={"x-api-key": API_KEY}
        )
        result = response.json()

        if result["status"] in ("done", "failed"):
            return result

        time.sleep(2)

results = get_results("a1b2c3")
print(results)

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const API_BASE = 'https://api.zerodrift.ai';

async function getResults(jobId) {
  while (true) {
    const response = await axios.get(
      `${API_BASE}/api/v3/jobs/${jobId}`,
      { headers: { 'x-api-key': API_KEY } }
    );

    if (['done', 'failed'].includes(response.data.status)) {
      return response.data;
    }

    await new Promise(resolve => setTimeout(resolve, 2000));
  }
}

const results = await getResults('a1b2c3');
console.log(results);

Getting Started

Validate

Custom Policies

Activities

Rule Packs

Get Validation Results

Path Parameters

Response

Status Values

Error Responses

Example

​Path Parameters

​Response

​Status Values

​Error Responses

​Example

Path Parameters

Response

Status Values

Error Responses

Example