API Documentation
Simple REST API for document verification. Full code examples in Python, JavaScript, and cURL.
Quick Start
Authentication
All API requests require an API key. Pass it in the Authorization header as a Bearer token.
Authorization: Bearer YOUR_API_KEY
Create Analysis
Submit a document for verification.
POST /v1/jobs
Content-Type: multipart/form-data
document: <file>
Response:
{
"job_id": "job_abc123",
"status": "processing",
"created_at": "2026-04-05T10:30:00Z"
}
Get Job Status
Check the status of a verification job.
GET /v1/jobs/job_abc123
Response:
{
"job_id": "job_abc123",
"status": "completed",
"score": 94,
"grade": "A",
"verdicts": [
{
"claim": "Revenue increased 8.2%",
"verdict": "VERIFIED",
"sources": ["SEC EDGAR"]
}
],
"certificate": "gs_cert_xyz789",
"signature": "ed25519_signature_here"
}
Retrieve Transcript
Download the full analysis transcript (PDF, Markdown, or text).
GET /v1/jobs/job_abc123/transcript?format=pdf
Returns: PDF file with full agent debate, verdicts, and source citations.
Endpoint Reference
POST
/v1/jobsSubmit a document for verification
GET
/v1/jobs/{{job_id}} Get job status and results
GET
/v1/jobs/{{job_id}}/transcriptDownload analysis transcript
GET
/v1/account/creditsGet account credit balance
Code Examples
Python
import requests
API_KEY = "your_api_key_here"
headers = {"Authorization": f"Bearer {API_KEY}"}
# Submit document
with open("document.pdf", "rb") as f:
files = {"document": f}
response = requests.post(
"https://api.gauntletscore.com/v1/jobs",
headers=headers,
files=files
)
job = response.json()
job_id = job["job_id"]
# Get results
response = requests.get(
f"https://api.gauntletscore.com/v1/jobs/{job_id}",
headers=headers
)
results = response.json()
print(f"Score: {results['score']}, Grade: {results['grade']}")
JavaScript
const API_KEY = "your_api_key_here";
// Submit document
const formData = new FormData();
formData.append("document", document.querySelector("input[type='file']").files[0]);
const response = await fetch("https://api.gauntletscore.com/v1/jobs", {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}` },
body: formData
});
const job = await response.json();
const jobId = job.job_id;
// Get results
const resultsResponse = await fetch(
`https://api.gauntletscore.com/v1/jobs/${jobId}`,
{ headers: { "Authorization": `Bearer ${API_KEY}` } }
);
const results = await resultsResponse.json();
console.log(`Score: ${results.score}, Grade: ${results.grade}`);`
cURL
# Submit document
curl -X POST https://api.gauntletscore.com/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "document=@document.pdf"
# Get results
curl https://api.gauntletscore.com/v1/jobs/job_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"
GauntletScore provides assistive verification and is not a substitute for professional judgment.