VERITAS API docs

curl

# Browse the full catalog
curl https://sourcescore.org/api/v1/claims.json | jq '.count, .claims[0]'

# Fetch a specific claim (e.g. GPT-4 release date)
curl https://sourcescore.org/api/v1/claims/09eea8fb1a8ccebf.json

# Search for claims about a topic
curl "https://sourcescore.org/api/v1/search?q=llama&limit=5"

# Match a natural-language claim against the catalog
curl -X POST https://sourcescore.org/api/v1/verify \
  -H 'Content-Type: application/json' \
  -d '{"claim": "Llama 3.1 was released in July 2024"}'

JavaScript (fetch)

// Browse catalog
const catalog = await fetch('https://sourcescore.org/api/v1/claims.json')
  .then(r => r.json());
console.log(`${catalog.count} verified claims`);

// Fetch by id
const claim = await fetch(
  'https://sourcescore.org/api/v1/claims/09eea8fb1a8ccebf.json'
).then(r => r.json());
console.log(claim.citedAs);

// Verify a natural-language claim
const verification = await fetch(
  'https://sourcescore.org/api/v1/verify',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      claim: 'Llama 3.1 was released in July 2024',
    }),
  },
).then(r => r.json());

if (verification.bestMatch) {
  console.log('Candidate record:', verification.bestMatch.statement);
} else {
  console.log('No candidate record cleared the retrieval gates.');
}

Python (requests)

import requests

# Browse catalog
catalog = requests.get(
    'https://sourcescore.org/api/v1/claims.json'
).json()
print(f'{catalog["count"]} verified claims')

# Fetch by id
claim = requests.get(
    'https://sourcescore.org/api/v1/claims/09eea8fb1a8ccebf.json'
).json()
print(claim['citedAs'])

# Match a natural-language claim against the catalog
verification = requests.post(
    'https://sourcescore.org/api/v1/verify',
    json={'claim': 'Llama 3.1 was released in July 2024'},
).json()

if verification.get('bestMatch'):
    print('Candidate record:', verification['bestMatch']['statement'])
else:
    print('No candidate record cleared the retrieval gates.')

Request

curl "https://sourcescore.org/api/v1/search?q=llama&limit=3"

Response

{
  "apiVersion": "v1",
  "methodology": "https://sourcescore.org/methodology/",
  "query": "llama",
  "count": 3,
  "results": [
    {
      "id": "c1a2b3d4e5f6a7b8",
      "subject": "Llama 3.1",
      "predicate": "released_on",
      "object": "2024-07-23",
      "statement": "Llama 3.1 released on: 2024-07-23.",
      "confidence": 1,
      "signatureShort": "5b27aa11",
      "detailUrl": "https://sourcescore.org/api/v1/claims/c1a2b3d4e5f6a7b8.json"
    }
  ]
}

Request

POST /api/v1/verify
Content-Type: application/json

{
  "claim": "Llama 3.1 was released in July 2024",
  "vertical": "ai-ml",
  "minConfidence": 0.85
}

Illustrative response shape (candidate found)

{
  "apiVersion": "v1",
  "methodology": "https://sourcescore.org/methodology/",
  "query": "Llama 3.1 was released in July 2024",
  "minConfidence": 0.85,
  "method": "keyword",
  "note": "matchScore is similarity, not a truth verdict.",
  "matches": [
    {
      "claim": {
        "id": "a55484ab8b4bdf4e",
        "subject": "Llama 3.1",
        "predicate": "released_on",
        "object": "2024-07-23",
        "statement": "Llama 3.1 released on: 2024-07-23.",
        "confidence": 1,
        "signatureShort": "<current prefix>",
        "detailUrl": "https://sourcescore.org/api/v1/claims/a55484ab8b4bdf4e.json"
      },
      "matchScore": 0.42,
      "rationale": "Keyword overlap on: llama, released, 2024."
    }
  ],
  "bestMatch": { "id": "a55484ab8b4bdf4e", ... },
  "signature": {
    "algorithm": "HMAC-SHA256",
    "signedBy": "did:web:sourcescore.org",
    "signedAt": "<response time>",
    "signature": "..."
  }
}

Illustrative response shape (no candidate cleared the gates)

{
  "apiVersion": "v1",
  "methodology": "https://sourcescore.org/methodology/",
  "query": "GPT-5 reaches AGI in 2025",
  "minConfidence": 0.85,
  "method": "keyword",
  "note": "matchScore is similarity, not a truth verdict.",
  "matches": [],
  "notVerified": true,
  "signature": { "algorithm": "HMAC-SHA256", ... }
}