API & Webhooks

Backend Configuration

To securely fetch verification session details from your backend server:

GET /api/v1/checker-widget/sdk/sessions/{session_id}/

Headers:
x-api-key: your_secret_api_key
x-organisation-id: your_org_id

Webhook Specifications

Configure your webhook URL in the Prembly dashboard to receive real-time updates when a user completes a verification flow.

// Example Webhook Listener (Node.js/Express)
app.post('/api/webhooks/prembly', express.json(), async (req, res) => {
const { event, session_id, data } = req.body;
if (event === 'verification.completed') {
// Process the verified data
console.log(`Session ${session_id} completed`, data);
}
// Always return a 200 OK
res.status(200).json({ received: true });
});


Did this page help you?