AegisAPI Reference
Base URL: https://api.aegis-dig.com
Request Format
All requests must include:
Authorization: Bearer {api_key}headerContent-Type: application/jsonfor POST requests
Response Format
json
{
"request_id": "req_abc123",
"data": {},
"meta": {
"latency_ms": 42,
"quota_remaining": 9850
}
}
Error Format
json
{
"error": {
"code": "VALIDATION_ERROR",
"message": "CPF number is invalid",
"details": [{ "field": "cpf", "message": "Checksum mismatch" }],
"request_id": "req_xyz789"
}
}
Error Codes
| Code | HTTP | Description |
|---|---|---|
UNAUTHORIZED | 401 | Invalid API key |
FORBIDDEN | 403 | Insufficient permissions |
NOT_FOUND | 404 | Resource not found |
VALIDATION_ERROR | 422 | Invalid request body |
RATE_LIMITED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Server error |
Rate Limits
| Plan | req/min | req/day |
|---|---|---|
| Starter | 60 | 10,000 |
| Growth | 600 | 100,000 |
| Enterprise | Custom | Unlimited |
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/verify/cpf | POST | Validate CPF number |
/v1/verify/cnpj | POST | Validate CNPJ number |
/v1/credit/score | POST | Get credit score |
/v1/fraud/check | POST | Anti-fraud check |
/v1/ocr/document | POST | Document OCR |
/v1/consent | POST | LGPD consent |