Get up and running with the Qubiclo API in minutes. Authenticate, submit your first claim, and understand the full adjudication workflow.
Authenticate & Get Access Token
Use your email and password to obtain a JWT access token.
curl -X POST http://localhost:8000/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"email": "admin@yourhmo.com",
"password": "your_password"
}'Response:
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 900,
"token_type": "bearer"
}Submit Your First Claim
Send a claim for adjudication using the Claims Intake API.
curl -X POST http://localhost:8000/api/v1/claims/intake \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"claim_id": "CLM-2026-1001",
"member_id": "MBR-88273",
"provider_id": "PRV-102",
"diagnosis_codes": ["J18.9"],
"procedure_codes": ["71045"],
"claim_amount": 125000,
"currency": "NGN",
"service_date": "2026-05-20"
}'Check the Adjudication Result
Poll the claim status or receive a webhook notification.
curl -X GET http://localhost:8000/api/v1/claims/CLM-2026-1001 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Response when processed:
{
"status": "approved",
"adjudication_outcome": "APPROVED",
"approved_amount": 125000,
"fraud_score": 0.12,
"audit_id": "aud_xyz789",
"processed_at": "2026-05-20T10:31:45Z"
}Review Fraud Analysis
Deep dive into fraud scoring and pricing validation.
curl -X GET http://localhost:8000/api/v1/fraud/assessments?claim_id=CLM-2026-1001 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Set Up Webhooks
Receive real-time notifications about claim status changes.
Configure your webhook URL via POST /webhooks. You'll receive signed events like:
{
"event": "claim.completed",
"timestamp": "2026-05-20T10:31:45Z",
"data": {
"claim_id": "CLM-2026-1001",
"status": "approved",
"outcome": "APPROVED"
},
"signature": "sha256=..."
}