v1OpenAPI 3.1 · REST · JSON

Your first policy, issued in 5 minutes

One API for KYC, quotes, policies, claims, OCR, notifications and renewals. Try every endpoint in the sandbox below — no signup, no real data.

Open sandbox API reference OpenAPI spec Postman collection

Base URL

https://sandbox.insurex24.com/v1

Auth

Authorization: Bearer sk_test_…

Safe retries

Idempotency-Key: <uuid>

Errors

{ error: { type, code, message } }

Quickstart

KYC → Quote → Policy → Webhook

Sandbox

Call the API right here

Runs in your browser against mock data that follows the same schema, validation rules and error format as the real API. Try removing a required field, using a bad key, or Aadhaar ending 0000.

REQUEST
RESPONSE

          
Pick an endpoint and press Send…

        

        
Equivalent cURL

      

    

    

      
Prefer your own tools? Run the same sandbox locally

      
npx @stoplight/prism-cli mock https://insurex24.com/openapi.yaml
# → mock API on http://127.0.0.1:4010 — point Postman's {{baseUrl}} here

      
Or open the spec in Swagger Editor or import it straight into Postman, Insomnia or your code generator (openapi-generator).

    

  







  

    

      
Status codes

      

        
CodeMeaning

        
200 / 201Success / created

        
202Accepted — async job (renewals, notifications)

        
400Malformed request or missing field — see param

        
401Missing or invalid API key

        
404Resource not found

        
409Idempotency-Key reused with a different body

        
422Valid JSON, but breaks a business rule

        
429Rate limited — honour Retry-After

      

    

    

      
Sandbox test values

      

        
InputResult

        
Aadhaar ending 1234KYC verified

        
Aadhaar ending 0000KYC failed — identity_mismatch

        
estimated_loss > 500000Claim under_review, high fraud risk

        
Mobile +919999999999SMS undelivered

        
Key not starting sk_test_401 invalid_api_key

      

    

  







  

    

      

        
API reference

        
Every endpoint, schema and webhook

      

      Full reference
    

    

        POST/kyc/verify
        POST/quotes
        POST/policies/issue
        GET/policies
        GET/policies/{policy_id}
        POST/claims/submit
        GET/claims/{claim_id}
        POST/renewals/trigger
        POST/ocr/extract
        POST/notifications/send
        HOOKpolicy.issued · claim.status_changed · renewal.completed
    

  







  

    
Ready for live keys?

    
Tell us what you're building. We'll issue production keys and help you ship your first integration.

    Request production access