Claims

Insurance claims raised against a vehicle, from first notification through to repair status.

Base URL
https://api.reportauto.eu

Claims

Insurance claims raised against a vehicle. A claim usually hangs off an existing request — pass request_id and session_key to associate the two — and moves through a status as the insurer and repair shop work it.

Create a claim

POST/api/claims

Raises a claim and, when request_id and session_key are given, associates it with an existing request. Identify the vehicle either by plate or by an existing report_id.

Authentication API key

Parameters

driver_namestring

Name of the driver.

driver_phonestring

Driver’s phone number.

driver_emailstring

Driver’s email address.

platestring

Registration plate. Use this or report_id.

report_idinteger

Existing report for the vehicle. Use this or plate.

damage_descriptionstring

What happened to the vehicle.

insurer_idinteger

Insurer handling the claim.

repair_shop_idinteger

Repair shop assigned to the claim.

reportedinteger

Whether the incident has been reported to the insurer.

claim_typestring

Type of cover, e.g. KASKO.

request_idinteger

Request to associate the claim with.

session_keystring

Session key of that request.

  • A claim can also be opened from the listing side by posting to /api/requests/self with request_type CLAIM — see Listings.
cURL
1curl -X POST "https://api.reportauto.eu/api/claims" \
2  -H "Authorization: API_KEY $CAROOM_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "driver_name": "Jamie Rivera",
6    "driver_phone": "+37256781111",
7    "driver_email": "jamie@example.com",
8    "plate": "952MGV",
9    "damage_description": "Some issue with the wheels",
10    "insurer_id": 1,
11    "repair_shop_id": 26,
12    "reported": 1,
13    "claim_type": "KASKO",
14    "request_id": 205,
15    "session_key": "3dfd3df1-c0d0-4ad2-9e0a-bdd9738c7ef3"
16  }'

List claims

GET/api/claims

Returns the claims visible to the caller. Filter by type to get the preclaim queue — claims raised but not yet fully reported.

Authentication API key

Query parameters

typestring

Filter by claim stage, e.g. preclaim.

  • Send `X-API-Version: 2` for the current response shape.
cURL
1curl "https://api.reportauto.eu/api/claims?type=preclaim" \
2  -H "Authorization: API_KEY $CAROOM_API_KEY" \
3  -H "X-API-Version: 2"

Update a claim

PATCH/api/claims/:claim_id

Updates the claim’s details or moves it to a new status. Status accepts either the string name or its numeric code.

Authentication API key

Path parameters

claim_idintegerRequired

ID of the claim.

Parameters

statusstring or integer

New status, e.g. "REPAIRABLE" or its numeric equivalent.

damage_descriptionstring

Updated description of the damage.

insurer_idinteger

Insurer handling the claim.

repair_partner_idinteger

Repair partner assigned to the claim.

reportedinteger

Whether the incident has been reported to the insurer.

claim_typestring

Type of cover, e.g. KASKO.

cURL
1curl -X PATCH "https://api.reportauto.eu/api/claims/318" \
2  -H "Authorization: API_KEY $CAROOM_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "damage_description": "Some issue with the wheels",
6    "insurer_id": 1,
7    "repair_partner_id": 1,
8    "reported": 1,
9    "claim_type": "KASKO"
10  }'