Wardya Developers / API Reference

API Reference

Public sandbox API reference for Wardya Identity Data Intelligence. This reference exposes only approved public endpoints and safe example payloads.

Public docs use sandbox-only examples. Production credentials, private partner integrations, internal architecture, and deployment details are shared only through approved onboarding.

Wardya Public API

Sandbox API reference

Version v1SandboxBackend only

Base URL

https://api.wardya.ai/v1
POST/webhooks/test

Send sandbox webhook event

Queue a safe test event to your backend webhook receiver. Enterprise teams use this endpoint from staging services to validate signature verification, retry handling, idempotency, audit correlation, and operational alert routing before production onboarding.

Auth

Server-side bearer key

Validate receiver readiness

Confirm signature handling

Record audit correlation

Request body

{
  "eventType": "identity.verification.completed",
  "tenantId": "tenant_demo",
  "deliveryUrl": "https://example.com/webhooks/wardya",
  "correlationId": "corr_01J9Y7QK8F5R2N4M6T0Z",
  "data": {
    "verificationId": "vr_8f28",
    "status": "approved",
    "riskLevel": "low"
  }
}

200 response

{
  "eventId": "evt_test_01J9Y7QK8F5R2N4M6T0Z",
  "status": "queued",
  "deliveryMode": "sandbox",
  "signatureHeader": "Wardya-Signature"
}
FieldTypeRequirementEnterprise use
eventTypestringRequiredSandbox event name to deliver to the configured webhook endpoint.
tenantIdstringRequiredApproved tenant or sandbox workspace identifier.
deliveryUrluriRequiredYour backend webhook receiver. Browser clients should not call Wardya directly.
correlationIdstringRecommendedCustomer-generated trace id for reconciliation, support, and audit review.
dataobjectRequiredSafe sandbox payload that mirrors the event shape without production data.
Keep Wardya API keys in server-side configuration only. Web and mobile clients should call your backend, and your backend should call Wardya with approved sandbox or production credentials.