Sources & Auditing

Example 1 — verify with inline claims and inline source content

POST /v2/verify
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "claims": [
    { "id": "c1", "text": "We can refund purchases within 30 days of purchase." }
  ],
  "sources": [
    {
      "source_id": "s1",
      "type": "text",
      "title": "Refund Policy",
      "content": "Refunds are permitted within 30 days of purchase."
    }
  ]
}

Example 2 — reference a stored source_id

POST /v2/verify
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "claims": [ { "id": "c1", "text": "Refunds are allowed within 30 days." } ],
  "sources": [ { "source_id": "src_abc123" } ]
}

Example 3 — ingest a URL as a source (two-step model)

# Step 1: ingest (server fetch + extract + persist)
POST /v2/sources
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "sources": [
    {
      "type": "html",
      "title": "Refund Policy",
      "uri": "https://example.com/policies/refund-v3.html"
    }
  ]
}

# Response (example)
{
  "sources": [
    { "source_id": "src_abc123", "type": "html", "uri": "https://example.com/policies/refund-v3.html", "checksum": "sha256:..." }
  ],
  "errors": []
}

# Step 2: verify using the stored source_id (deterministic by default)
POST /v2/verify
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "claims": [ { "id": "c1", "text": "Refunds are allowed within 30 days." } ],
  "sources": [ { "source_id": "src_abc123" } ]
}

Optional — allow URL fetching during verify (explicit opt-in)

POST /v2/verify
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "claims": [ { "id": "c1", "text": "Refunds are allowed within 30 days." } ],
  "sources": [
    { "type": "html", "title": "Refund Policy", "uri": "https://example.com/policies/refund-v3.html" }
  ],
  "options": { "allow_network": true }
}

Upload PDF Example (multipart)

# cURL (multipart)
curl -X POST 'https://factara-api.fly.dev/v2/sources' \
  -H 'Authorization: Bearer REPLACE_WITH_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'title=Refund policy'

# Node.js (fetch + form-data)
import fs from 'fs';
import FormData from 'form-data';

const form = new FormData();
form.append('file', fs.createReadStream('document.pdf'));
form.append('title', 'Refund policy');

const res = await fetch('https://factara-api.fly.dev/v2/sources', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer REPLACE_WITH_API_KEY', ...form.getHeaders() },
  body: form
});
console.log(await res.json());

# Python (requests)
import requests

with open('document.pdf', 'rb') as f:
  files = {'file': ('document.pdf', f, 'application/pdf')}
  data = {'title': 'Refund policy'}
  res = requests.post(
    'https://factara-api.fly.dev/v2/sources',
    headers={'Authorization': 'Bearer REPLACE_WITH_API_KEY'},
    files=files,
    data=data
  )
  print(res.json())

# Response (example)
{
  "sources": [
    {
      "source_id": "src_abcdef123456",
      "type": "pdf",
      "title": "Refund policy",
      "checksum": "sha256:...",
      "status": "created",
      "bytes": 123456
    }
  ],
  "errors": []
}

Note: uploads are size-limited and rate-limited. Extraction failures are reported per-source in errors.