API Documentation

Complete reference for the Hallucinot verification API.

Quick Start

Get started with the Hallucinot API in minutes. Verify AI-generated content and detect hallucinations with a single API call.

1. Get your API key

Sign up and create an API key from your Dashboard.

2. Make your first request

curl -X POST https://api.hallucinot.ai/v1/verify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "content": "The Eiffel Tower was built in 1889 and is located in Berlin.",
    "context": "geography"
  }'

3. Review the response

{
  "summary_score": 0.5,
  "verifications": [
    {
      "claim": "The Eiffel Tower was built in 1889",
      "status": "verified",
      "confidence": 0.95,
      "sources": [
        {
          "title": "Official Eiffel Tower Website",
          "url": "https://www.toureiffel.paris/en"
        }
      ]
    },
    {
      "claim": "is located in Berlin",
      "status": "hallucinated",
      "confidence": 0.98,
      "reason": "The Eiffel Tower is in Paris, France, not Berlin.",
      "suggested_fix": "The Eiffel Tower is located in Paris, France."
    }
  ],
  "metadata": {
    "claims_found": 2,
    "processing_time_ms": 1250
  }
}

Claim Statuses

verified

Claim is factually accurate and supported by sources

hallucinated

Claim is factually incorrect or contradicted by sources

inconsistent

Claim partially matches sources but contains errors

unverifiable

Unable to verify claim with available sources

Rate Limits

PlanRequests/MonthRate LimitBatch Size
Starter1,000100 req/min5 items
Professional10,000500 req/min10 items
Enterprise100,000+Custom50 items

Rate limit headers are included in all responses: X-RateLimit-Remaining, X-RateLimit-Reset