Let policyholders take verified live photos with SafeCam. Your system creates a SafeCam case for one of your case numbers, receives the capture link and follows the case via status polling or an automatic result push.
Base URL: https://api.vaarhaft.com/safecam - Authentication: the same API key as for the FraudScanner (x-api-key: <api key>, alternatively Authorization: Bearer <api key>).
Flow
POST /safecam/link- create the case, receivesafecamLinkandticketId.- The link reaches the policyholder - sent by Vaarhaft (
vaarhaft_versand) or by you (eigenversand). - The policyholder takes the photos; they are checked automatically.
GET /safecam/status- poll the state, or receive the result push when the case is closed.
SafeCam photos are not automatically compared with images sent to the FraudScanner.
Creates a SafeCam case for one of your case numbers and returns the link the policyholder uses to take live photos.
- Only one open SafeCam case per case number is allowed. If one already exists you get
409together with the existing link, so repeating the call is safe. - Whether Vaarhaft sends the link to the policyholder (e-mail / SMS) or you pass it on yourself is defined by your account configuration (
communicationMode), not by this call. - The case appears on the SafeCam board of the FraudScanner UI and can be handled there like any other SafeCam case.
communicationMode | Behaviour |
|---|---|
vaarhaft_versand | Vaarhaft sends the link by e-mail and/or SMS. vnName plus vnEmail or vnPhone are required. notificationStatus tells you what was sent. |
eigenversand | Nothing is sent by Vaarhaft; you forward safecamLink yourself. Policyholder fields are optional. |
Your case number. Slashes are allowed.
Policyholder e-mail for the invitation. In mode vaarhaft_versand vnEmail or vnPhone is required.
Policyholder mobile number (international format) for the SMS invitation.
Up to three guided capture steps. Without scenes the policyholder takes a free series of photos. Only the first three entries are used; entries whose description is shorter than 5 or longer than 100 characters are ignored.
Send reminders to the policyholder if the capture is not completed.
- https://api.vaarhaft.comhttps://api.vaarhaft.com/safecam/link
curl -i -X POST \
https://api.vaarhaft.com/safecam/link \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-d '{
"caseNumber": "300/2025/012578",
"sbEmail": "claims.handler@insurer.com",
"vnName": "Max Mustermann",
"vnEmail": "max@example.com",
"vnPhone": "+491701234567",
"customNote": "Please also take a photo of the type plate.",
"scenes": [
{
"description": "Full view of the vehicle"
},
{
"description": "Close-up of the damage at the rear"
}
]
}'SafeCam case created.
vaarhaft_versand - Vaarhaft sends the link; eigenversand - you forward the link yourself.
{ "ticketId": "8d0c1f3e-4b7a-4f7e-9a51-2c6f0b9d1e42", "caseNumber": "300/2025/012578", "safecamLink": "https://easycapture.de/#session=3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6", "sessionId": "3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6", "communicationMode": "vaarhaft_versand", "notificationStatus": { "emailSent": true, "smsSent": true } }