API DOCUMENTATION
Identity Verification API
Integrate blockchain-verified identity checks into your application with our secure REST API.
Secure
256-bit encryption with API key authentication
Fast
Real-time identity verification in milliseconds
RESTful
Standard JSON responses, works with any language
Authentication
All API requests require an API key. Obtain your key from the Admin Panel → API Keys tab.
GET https://usaid.app/api/kycQuery Headers: X-API-Key: your_api_key_here
KYC Query Endpoint
Verify identity status by email or wallet address.
Request
GET https://usaid.app/api/kycQuery?email=user@example.com Headers: X-API-Key: your_api_key
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| string | User's email address | |
| wallet | string | Blockchain wallet address (optional) |
Response (200 OK)
{
"success": true,
"data": {
"status": "verified",
"verification_date": "2026-03-15",
"blockchain_hash": "0xabc123...",
"ai_verified": true,
"liveness_verified": true,
"sanctions_cleared": true,
"sanctions_risk_level": "low",
"pep_flag": false
}
}Status Codes
Code Examples
JavaScript / Node.js
const response = await fetch('https://usaid.app/api/kycQuery?email=user@example.com', {
headers: {
'X-API-Key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data);Python
import requests
headers = {"X-API-Key": "your_api_key_here"}
params = {"email": "user@example.com"}
response = requests.get("https://usaid.app/api/kycQuery", headers=headers, params=params)
data = response.json()
print(data)cURL
curl -X GET "https://usaid.app/api/kycQuery?email=user@example.com" \ -H "X-API-Key: your_api_key_here"
Best Practices
Store API keys securely in environment variables, never commit them to version control
Implement rate limiting on your end to avoid excessive API calls
Cache verification results when appropriate to reduce API usage
Use HTTPS for all API requests to ensure data security
Monitor your API usage in the Admin Panel dashboard
Handle error responses gracefully in your application
Ready to integrate?
Get Your API Key