OpenEvidence Common Errors
Overview
Quick reference for OpenEvidence API errors with solutions.
401 — Authentication Failed
Fix: Verify API key at OpenEvidence developer portal.
403 — Organization Access Denied
Fix: Verify org ID and API key permissions.
422 — Invalid Query
Fix: Clinical question must be medical in nature.
429 — Rate Limited
Fix: Implement backoff. Check Retry-After header.
503 — Service Unavailable
Fix: DeepConsult queue may be full. Retry after delay.
Quick Diagnostic
# Check API connectivity
curl -s -w "\nHTTP %{http_code}" https://api.openevidence.com/v1/health 2>/dev/null || echo "Endpoint check needed"
echo $OPENEVIDENCE_API_KEY | head -c 10
Resources
Next Steps
See openevidence-debug-bundle.