Get the status of a SafeCam case

Request

Returns the current state of a SafeCam case, also after it has been closed. Pass either ticketId (exactly this case) or caseNumber (the most recent SafeCam case for this case number). Internal free text such as notes of claims handlers is never returned.

status (board column)

Value	Meaning
`sent`	Link created, policyholder has not finished yet
`reminder`	A reminder was sent, still open
`manual`	Waiting for review by a claims handler
`closed`	Closed - `finalDecision` is set

lastResult

Value	Meaning
`pending`	No result yet
`io`	Captures are inconspicuous
`nicht_io`	Captures are suspicious (e.g. photo of a screen, manipulated camera)
`io_gps_suspicious`	Images inconspicuous, location suspicious - manual review
`io_scene_override`	Images inconspicuous, a scene was submitted despite a failed scene check - manual review
`inspection_requested`	Policyholder asked for an on-site inspection instead of photos
`claim_withdrawn`	Policyholder withdrew the claim

finalDecision

Value	Meaning
`closed_io`	Closed automatically, captures inconspicuous
`betrug_bestaetigt`	Claims handler confirmed fraud
`manuell_geprueft`	Claims handler reviewed manually, OK
`sonstiges`	Other

Security

apiKeyAuth or safecamBearerAuth

Query

ticketIdstring

ticketId returned by POST /safecam/link.

caseNumberstring

Your case number (URL-encoded). Used when ticketId is not given.

x-api-keystringrequired

Your Vaarhaft API key.

curl -i -X GET \
  'https://api.vaarhaft.com/safecam/status?ticketId=string&caseNumber=string' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

Current state of the SafeCam case.

Bodyapplication/json

ticketIdstring

Example:"8d0c1f3e-4b7a-4f7e-9a51-2c6f0b9d1e42"

caseNumberstring

Example:"300/2025/012578"

statusstring

Enum:"sent""reminder""manual""closed"

Example:"closed"

closedboolean

Example:true

lastResultstring or null

Enum:"pending""io""nicht_io""io_gps_suspicious""io_scene_override""inspection_requested""claim_withdrawn"

Example:"io"

finalDecisionstring or null

Enum:"closed_io""betrug_bestaetigt""manuell_geprueft""sonstiges"

Example:"closed_io"

attemptCountinteger

Capture attempts in the current session.

Example:1

retriggerCountinteger

How often a new link was issued for this case.

Example:0

reminderCountinteger

Example:0

createdAtstring or null, (date-time)

Example:"2026-09-23T10:15:00+02:00"

updatedAtstring or null, (date-time)

Example:"2026-09-23T11:02:41+02:00"

closedAtstring or null, (date-time)

Example:"2026-09-23T11:02:41+02:00"

communicationModestring(SafeCamCommunicationMode)

vaarhaft_versand - Vaarhaft sends the link; eigenversand - you forward the link yourself.

Enum:"vaarhaft_versand""eigenversand"

Example:"vaarhaft_versand"

safecamLinkstring

Link of the current session.

Example:"https://easycapture.de/#session=3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6"

sessionsArray of objects

One entry per issued link (a re-trigger adds a session).

Example:

[
  {
    "sessionNumber": 1,
    "sessionId": "3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6",
    "safecamLink": "https://easycapture.de/#session=3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6",
    "triggeredAt": "2026-09-23T10:15:00+02:00",
    "attemptCount": 1,
    "finalStatus": "closed"
  }
]

scenesArray of objects

Example:

[
  {
    "description": "Full view of the vehicle",
    "completed": true
  },
  {
    "description": "Close-up of the damage at the rear",
    "completed": true
  }
]

resultPushobject or null

Outcome of the last result push to your endpoint; null if none happened.

Example:

{
  "status": "delivered",
  "at": "2026-09-23T11:02:43+02:00",
  "statusCode": 200
}

eventsArray of objects

Case history. Possible action values include safecam_triggered, safecam_scene_completed, safecam_result_io, safecam_result_nicht_io_final, safecam_inspection_requested, safecam_claim_withdrawn, reminder_sent_auto_first, reminder_sent_auto_followup, escalated_to_manual, safecam_retriggered, manually_closed, feedback_pushed, feedback_push_failed.

Example:

[
  {
    "timestamp": "2026-09-23T10:15:00+02:00",
    "action": "safecam_triggered",
    "actor": "API"
  },
  {
    "timestamp": "2026-09-23T11:02:41+02:00",
    "action": "safecam_result_io",
    "actor": "SafeCam"
  }
]

Response

{
  "ticketId": "8d0c1f3e-4b7a-4f7e-9a51-2c6f0b9d1e42",
  "caseNumber": "300/2025/012578",
  "status": "closed",
  "closed": true,
  "lastResult": "io",
  "finalDecision": "closed_io",
  "attemptCount": 1,
  "retriggerCount": 0,
  "reminderCount": 0,
  "createdAt": "2026-09-23T10:15:00+02:00",
  "updatedAt": "2026-09-23T11:02:41+02:00",
  "closedAt": "2026-09-23T11:02:41+02:00",
  "communicationMode": "vaarhaft_versand",
  "safecamLink": "https://easycapture.de/#session=3f6c2a90-1b2c-4d5e-8f90-a1b2c3d4e5f6",
  "sessions": [
    { … }
  ],
  "scenes": [
    { … },
    { … }
  ],
  "resultPush": {
    "status": "delivered",
    "at": "2026-09-23T11:02:43+02:00",
    "statusCode": 200
  },
  "events": [
    { … },
    { … }
  ]
}