Introduction

Welcome to the Claire Customer Communication API !

This API is used to fetch data and handle all actions related to communication with customers.

We currently have the following communications available:

• Online check-in: Similar to airlines check-in, this communication is sent to the customer prior to his appointment
• Desk check-in: Used by receptionist with counter tablet, to allow the customer to check-in on site
• Keylocker check-in: For locations with Claire keylockers, to allow the customer to check-in while dropping his key
• Diagnose overview: Once the car has been checked by a mechanic, the receptionist can send this communication to ask the customer what is approved, what is not, and what needs more information
• Repair overview: Once the car is ready, the receptionist can send this communication to confirm what was done and what was not

More detail to be found in each section of this documentation.

Communication channels

We currently support two channels of communication with customers:

• Email
• SMS

More will be added in the future.

Authentication

Endpoints aimed at customers to read, upload attachments and answer communications use a communication key in the payload as authentication.

A communication key is unique, and valid through the whole appointment life-cycle, from check-in to repair overview, it does not change for each communication sent for an appointment.

This is done to ensure that a customer see the last communication available no matter from which Email/SMS he clicked.

Claire do not send these keys to anyone but the customer to guarantee that a communication was read and answered by the targeted customer.

When the dealer wants to control sending or displaying the communications, these keys are sent to the dealer through the webhook service, and the responsibility to not leak or use these keys instead of the customer rest on them, see more below.

Endpoints aimed at receptionist use claire authentication tokens as all other services aimed at them.

Third party control

Notifying customers

It is possible for a dealer to send the communications links themselves, contact Claire support to activate this feature.

Communication keys will be sent to the dealer when the customer need to be notified, using the Claire webhook service.

Once enabled the dealer is responsible for communicating the link to the customer, and liable to not use the key themselves.

The links to be communicated to the customer are:

• https://comm.clairedev.nl/#!/COMMUNICATION_KEY on the development environment
• https://mycarcheck.pro/#!/COMMUNICATION_KEY on the production environment

Custom frontend

It is also possible for the dealer to use its own frontend, in which case, they must not pre-fetch the communication themselves and later on have the customer read it from their system.

Instead, they must ensure that the communication is fetched when the customer read the communication.

Claire is not responsible for incorrect information shown to the receptionist if the dealer fail to ensure this.

If the dealer wish to augment the features available in the frontend of a communication, or store the communication data, two infrastructures are possible:

• Fetch the communication from the frontend code, and call the dealer backend as well after that when needed
• Set up a proxy backend between the frontend and Claire backend. This proxy backend must be used by the dealer frontend only to guarantee it's called when the customer read the communication

The same options are possible when uploading attachments or answering communications.

Endpoints responses

When a call to an endpoint succeed, this API responds with HTTP 200 and return the following body

{"data":{"seeEachEndpoint":"forTheDataReturnedHere"}}

When a call to an endpoint is done with invalid payload or parameters, or when a validation error occur, or when an expected error occur, this API reponds with HTTP 200 and return the following body:

{"errors":["error 1", "error 2", "error N"]}

See the Errors section for when other HTTP code are returned.

Global communication endpoints

These endpoints are to be used no matter what the current Communication Status is.

They respond and act accordingly to the current status of the communication.

Read communication

curl -X POST "API_BASE/v1/communication/read"

This endpoint will prepare any data needed for the current communication status, mark the communication as read if a customer key is used, and return the communication data to be displayed. This is a general endpoint, to be used when the customer or receptionist want to read the communication, no matter what the current status of the communication is (check-in, diagnose, repair...). Do not use this endpoint with a customer key to retrieve the communication for internal purpose, as the communication will be marked as read by the customer and shown as such in the appointment detail page in the Claire dashboard.

HTTP Request

POST /v1/communication/read

The request Body payload is:

{
    "key": ""
}

The request JSON response is:

{
    "created_on": "0001-01-01T00:00:00Z",
    "updated_on": "0001-01-01T00:00:00Z",
    "customer_communication_id": 0,
    "receptionist_key": "",
    "status": 0,
    "version": 0,
    "correct_phone": "",
    "correct_email": "",
    "star_rating_experience_message": "",
    "star_rating_experience": 0,
    "star_rating_service_message": "",
    "star_rating_service": 0,
    "star_rating_speed_message": "",
    "star_rating_speed": 0,
    "star_rating_feedback": "",
    "customer_id": null,
    "appointment_id": 0,
    "car_id": 0,
    "receptionist_id": null,
    "dealer_location_id": 0,
    "note": "",
    "customer": null,
    "appointment": null,
    "car": null,
    "receptionist": null,
    "check_in_results": [],
    "check_in_remarks": [],
    "diagnose_overview_results": [],
    "diagnose_overview_remarks": [],
    "results": [],
    "agreements": [],
    "events": [],
    "is_receptionist": false,
    "settings": null,
    "frontend_update_required": false
}

{
    "created_on": "0001-01-01T00:00:00Z",
    "updated_on": "0001-01-01T00:00:00Z",
    "customer_communication_id": 0,
    "receptionist_key": "",
    "status": 0,
    "version": 0,
    "correct_phone": "",
    "correct_email": "",
    "star_rating_experience_message": "",
    "star_rating_experience": 0,
    "star_rating_service_message": "",
    "star_rating_service": 0,
    "star_rating_speed_message": "",
    "star_rating_speed": 0,
    "star_rating_feedback": "",
    "customer_id": null,
    "appointment_id": 0,
    "car_id": 0,
    "receptionist_id": null,

Request schema

Response schema

This endpoint return an object of type CustomerCommunication, please refer to the JSON response column on the right, or to the Models and Enumeration section for more details.

Upload a remark attachment.

curl -X POST "API_BASE/v1/communication/upload_attachment" -H "Content-Type: multipart/form-data"

When the customer want to upload an attachment while writing a remark, this endpoint is used to upload it. The attachment URL returned can then be used when submitting the answer in the 'remarks.attachments'. A maximum of 10 files can be attached to one communication and each file are limited to 32Mb.

HTTP MultiPart Request

POST /v1/communication/upload_attachment

The request parts are:

--XXX
Content-Disposition: form-data; name=key

...
--XXX
Content-Disposition: form-data; name=file

...--XXX--

The request JSON response is:

{
    "url": ""
}

This request must be a multipart/form-data content-type with valid boundary for each part

Request parts schema

Response schema

This endpoint return an object with the following fields, please refer to the JSON response column on the right for an example.

Summarize the communication

curl -X POST "API_BASE/v1/communication/summarize"

This endpoint summarizes the communication using google generative ai.

HTTP Request

POST /v1/communication/summarize

The request Body payload is:

{
    "key": "",
    "intervention_ids": [],
    "check_in_service_ids": []
}

The request JSON response is:

{
    "summary": ""
}

Request schema

Response schema

This endpoint return an object with the following fields, please refer to the JSON response column on the right for an example.

Diagnose_overview

Answer a diagnose overview communication

curl -X POST "API_BASE/v1/diagnose_overview/answer"

When the customer read a diagnose overview communication, he is expected to answer it, using this endpoint.

HTTP Request

POST /v1/diagnose_overview/answer

The request Body payload is:

{
    "key": "",
    "results": [],
    "remarks": [],
    "correct_phone": null,
    "correct_email": null,
    "agreement_ids": [],
    "customer_name": ""
}

The request JSON response is:

This endpoint does not return anything, only the HTTP status code matters.

Request schema

Response schema

This endpoint does not return anything, only the HTTP status code matters.

Diagnose_overview_v2

Answer a diagnose overview communication

curl -X POST "API_BASE/v2/diagnose_overview/answer"

When the customer read a diagnose overview communication, he is expected to answer it, using this endpoint.

HTTP Request

POST /v2/diagnose_overview/answer

The request Body payload is:

{
    "key": "",
    "interventions": [],
    "replacements": [],
    "remarks": [],
    "correct_phone": null,
    "correct_email": null,
    "agreement_ids": [],
    "customer_name": ""
}

The request JSON response is:

This endpoint does not return anything, only the HTTP status code matters.

Request schema

Response schema

This endpoint does not return anything, only the HTTP status code matters.

Online_checkin

Customer answers a sent CustomCommunication

curl -X POST "API_BASE/v1/online_checkin/answer"

When the customer read an online check-in communication, he is expected to answer it, using this endpoint.

HTTP Request

POST /v1/online_checkin/answer

The request Body payload is:

{
    "key": "",
    "results": [],
    "remarks": [],
    "correct_phone": null,
    "correct_email": null,
    "agreement_ids": [],
    "customer_name": "",
    "preferred_communication_channel": null,
    "drop_in_acses_locker": false
}

The request JSON response is:

This endpoint does not return anything, only the HTTP status code matters.

Request schema

Response schema

This endpoint does not return anything, only the HTTP status code matters.

ACSES KeyLockers that are available to the Customer

curl -X POST "API_BASE/v1/online_checkin/is_acses_available"

If a Location has ACSES KeyLockers enabled and there is a LockerCell available in any LockerSystem. The Customer will be prompted to drop their keys in the Locker.

HTTP Request

POST /v1/online_checkin/is_acses_available

The request Body payload is:

{
    "key": ""
}

The request JSON response is:

{
    "available": false
}

Request schema

Response schema

This endpoint return an object with the following fields, please refer to the JSON response column on the right for an example.

Communication Controller

Communication controller for updating the customization and settings options for Communications

This controller controls the settings for all the Communication Services and provides Email and SMS templates for customization.

Download a PDF

curl -X POST "API_BASE/v1/repair_overview/download"

Download a PDF contained the Repair Order information

HTTP Request

POST /v1/repair_overview/download

The request Body payload is:

{
    "communication_key": ""
}

The request JSON response is:

[
    0
]

Request schema

Response schema

This endpoint returns a binary

Set the rating

curl -X POST "API_BASE/v1/repair_overview/set_star_rating"

This endpoint set the rating provided by customer for overall experience, speed and services.

HTTP Request

POST /v1/repair_overview/set_star_rating

The request Body payload is:

{
    "communication_key": "",
    "star_rating_experience": 0,
    "star_rating_speed": 0,
    "star_rating_service": 0,
    "star_rating_feedback": ""
}

The request JSON response is:

This endpoint does not return anything, only the HTTP status code matters.

Request schema

Response schema

This endpoint does not return anything, only the HTTP status code matters.

Models and Enumerations

Enumerations

AppointmentRecallStatus Enumeration

CarType Enumeration

CheckInResultStatus Enumeration

ChecklistType Enumeration

CommunicationChannelID Enumeration

CommunicationEventType Enumeration

CommunicationLayoutID Enumeration

CommunicationResultStatus Enumeration

CommunicationStatus Enumeration

CustomerType Enumeration

DBBStatus Enumeration

HeadingPosition Enumeration

LandingPageID Enumeration

LanguageCode Enumeration

LefLeadKind Enumeration

PinStatusID Enumeration

PinTypeID Enumeration

QuestionResultStatus Enumeration

RoleID Enumeration

StatusIdentifier Enumeration

StatusOverride Enumeration

TyrePosition Enumeration

TyreReplacementSource Enumeration

TyreTeamChannelID Enumeration

UserStatusID Enumeration

WarrantyTypeID Enumeration

Models

Appointment Model

Car Model

CheckInRemark Model

CheckInResult Model

CommunicationAgreement Model

CommunicationEvent Model

CommunicationResult Model

CommunicationSetting Model

Customer Model

CustomerCommunication Model

DiagnoseOverviewRemark Model

Intervention Model

User Model

VehicleTyreReplacement Model

Changelog

This section contains changes related to the CustomCom service. Changes will be included if:

• A new endpoint is added
• A new field is added to an existing endpoint
• Field description changes
• A field is deprecated

Notes - 08.07.2026

The following endpoint has been added:

• /v1/notes/high_voltage/refresh

WO TyreReplacements - 14.06.2026

The request of /v2/diagnose_overview/answer changed for WO tyre replacements:

• results was removed
• replacements was added, holding the replacements answered by the customer

Communication - 25-10-2025.

The following endpoint is included with this release:

• /v1/communication/summarize

Repair Overview PDF Download - 07-8-24

• /v1/repair_overview/download

Initial release - 03.11.2022.

The following endpoints are included with initial release:

• /v1/communication/read
• /v1/communication/upload_attachment
• /v1/online_checkin/answer
• /v1/diagnose_overview/answer

Errors

The Claire Automotive Support APIs uses the following error codes: