DEVELOPER API · v1.0

API Documentation

Integrate the Trust Layer Protocol into any application with a single REST API call. Secure, deterministic, cryptographically signed — built for production at scale.

Get API Key →View on GitHub →

AUTHENTICATION

API Keys

All API requests require a valid API key passed in the Authorization header as a Bearer token. Generate and manage keys from Credify Studio.

BASE URL

https://api.credify.dev

RATE LIMITS

100 requests/minute (Free) · 1,000 requests/minute (Pro)

CONTENT TYPE

application/json

authentication

# Header format
Authorization: Bearer crd_live_xxxxxxxxxxxx

# Example with curl
curl -X POST https://api.credify.dev/v1/verify \
-H "Authorization: Bearer crd_live_xxxx" \
-H "Content-Type: application/json" \
-d '{"text": "Earth orbits the Sun"}'

ENDPOINTS

Available Routes

POST/v1/verify

Verify Claim

Submit a natural language text to be verified. The protocol extracts factual claims, cross-references them against authoritative sources, and returns a Truth Score with full source attribution.

Parameter	Type	Required	Description
`text`	string	required	The text containing claims to verify
`strict_mode`	boolean	optional	Enable strict verification with higher source thresholds
`webhook_url`	string	optional	URL to receive async results for batch processing

GET/v1/claim/:id

Get Claim Details

Retrieve the full verification result for a previously submitted claim, including all extracted sub-claims, sources, stance analysis, and cryptographic signatures.

Parameter	Type	Required	Description
`id`	string	required	The claim ID returned from /v1/verify

GET/v1/history

Verification History

List all verification requests associated with your API key, paginated and filterable by date range, classification, or score threshold.

Parameter	Type	Required	Description
`page`	number	optional	Page number (default: 1)
`limit`	number	optional	Items per page (default: 25, max: 100)
`classification`	string	optional	Filter by VERIFIED, FALSE, or UNCERTAIN

POST/v1/batch

Batch Verification

Submit multiple texts for verification in a single request. Results are delivered asynchronously via webhooks or polling.

Parameter	Type	Required	Description
`items`	array	required	Array of { text, id } objects to verify
`webhook_url`	string	required	URL to receive batch results

RESPONSE FORMAT

Response Fields

truth_scorenumber

Confidence score from 0.00 to 1.00

classificationstring

VERIFIED (≥0.75), UNCERTAIN (0.40–0.74), or FALSE (<0.40)

claimsarray

Extracted sub-claims with individual scores and sources

sourcesarray

Authoritative sources used with stance (SUPPORTS/CONTRADICTS)

reasoningstring

Human-readable explanation of the verification decision

signaturestring

Cryptographic signature for audit trail verification

timestampstring

ISO 8601 timestamp of when verification was completed

200 OK

{
"status": "success",
"data": {
"claim_id": "clm_8f92j10x",
"truth_score": 0.91,
"classification": "VERIFIED",
"reasoning": "Multiple space agencies...",
"sources": [
{
"url": "https://nasa.gov/...",
"stance": "SUPPORTS"
}
],
"signature": "sig_a9f8b7c..."
}
}

ERROR HANDLING

Error Codes

400

Bad Request

Missing or malformed request body

401

Unauthorized

Invalid or missing API key

429

Rate Limited

Too many requests — retry after the specified delay

500

Server Error

Internal error — contact support if persistent

Start building today.

Generate your API key in Credify Studio and make your first verification request in under 60 seconds.

Get API Key →View on GitHub →