Get Verification
Retrieve a verification result by ID using the GET /v1/verify/:id endpoint.
Get Verification
Retrieve the details of a previously submitted verification.
GET
/v1/verify/:idFetch verification result by its unique identifier.
Path Parameters
| Parameter | Type | Description |
|---|
Example Request
Response
Success Response (200)
{
"id": "ver_abc123def456",
"status": "completed",
"content": "The original content that was verified...",
"verdict": "true",
"confidence": 0.95,
"decision": "accept",
"reasoning": "The claim is factually accurate based on multiple authoritative sources.",
"paradigmResults": [
{
"id": "pr_111",
"paradigm": "reasoning",
"verdict": "true",
"confidence": 0.94,
"reasoning": "Analysis indicates factual accuracy",
"provider": "anthropic",
"model": "claude-sonnet-4-5-20250929",
"processingTimeMs": 850
},
{
"id": "pr_222",
"paradigm": "tool",
"verdict": "true",
"confidence": 0.97,
"reasoning": "Confirmed by 3 authoritative sources",
"processingTimeMs": 1200
}
],
"processingTimeMs": 2100,
"costCents": 5,
"metadata": {
"source": "article-123"
},
"createdAt": "2024-01-15T10:30:00Z",
"completedAt": "2024-01-15T10:30:02Z"
}Pending Verification
If the verification is still processing:
{
"id": "ver_abc123def456",
"status": "processing",
"content": "The content being verified...",
"createdAt": "2024-01-15T10:30:00Z"
}Escalated Verification
If the verification was escalated for human review:
{
"id": "ver_abc123def456",
"status": "escalated",
"content": "The content being verified...",
"verdict": "uncertain",
"confidence": 0.45,
"escalation": {
"id": "esc_xyz789",
"reason": "low_confidence",
"priority": "high",
"deadline": "2024-01-16T10:30:00Z",
"status": "pending"
},
"createdAt": "2024-01-15T10:30:00Z"
}Error Responses
404 Not Found
{
"error": {
"code": "not_found",
"message": "Verification not found"
}
}403 Forbidden
{
"error": {
"code": "forbidden",
"message": "This verification belongs to a different organization"
}
}Polling for Results
For long-running verifications, you can poll this endpoint:
async function waitForVerification(id, maxAttempts = 30) {
for (let i = 0; i < maxAttempts; i++) {
const response = await fetch(`https://api.check.ai/v1/verify/${id}`, {
headers: { 'Authorization': `Bearer ${apiKey}` },
});
const result = await response.json();
if (result.status === 'completed' || result.status === 'escalated') {
return result;
}
// Wait 1 second before next attempt
await new Promise(resolve => setTimeout(resolve, 1000));
}
throw new Error('Verification timed out');
}Use Webhooks Instead
For production applications, we recommend using webhooks instead of polling. Webhooks provide instant notifications and reduce unnecessary API calls.