API Documentation

{
  "text": "Their going to the store becuz they needs more supplys.",
  "aggressiveness": 1,
  "tenant_id": "your-tenant-id"
}

curl -X POST https://human-grammar-api.fly.dev/v1/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hg_your_api_key" \
  -d '{
    "text": "Their going to the store becuz they needs more supplys.",
    "aggressiveness": 1
  }'

{
  "original_text": "Their going to the store becuz they needs more supplys.",
  "corrected_text": "They're going to the store because they need more supplies.",
  "voice_drift_score": 0.08,
  "issues": [
    {
      "category": "grammar",
      "severity": "error",
      "message": "Use 'They're' instead of 'Their'",
      "offset": 0,
      "length": 5
    },
    {
      "category": "spelling",
      "severity": "error",
      "message": "Correct spelling: 'because'",
      "offset": 27,
      "length": 5
    }
  ],
  "diff": [
    {
      "type": "replace",
      "original": "Their",
      "corrected": "They're",
      "start": 0,
      "end": 5
    }
  ],
  "processing_ms": 342,
  "request_id": "req_abc123",
  "provider_trace": {
    "stages_executed": [
      "rule_based",
      "model_gec",
      "voice_lock",
      "drift_scoring",
      "selection"
    ]
  }
}