API · Dossieropvolging
Koppel uw software aan de dossieropvolging van SellViaApp.
Maak interventies aan, wijs technici toe en beheer berichten, documenten, offertes, goedkeuringen, checklists, herhalingen en tijdregistraties vanuit uw eigen systeem.
Basis-URL
https://api.sellviaapp.com/Required headers
Developer supportapi@sellviaapp.com
X-API-Key + BearerComplete reference
64 case-tracking endpoints, all documented.
Every route below includes its method, access level, required and optional parameters, possible responses, and can generate a ready-to-copy request.
64routes
10business groups
21read routes
43write routes
GET
/case/knowledge/categories
GET/case/knowledge/search
GET/case/knowledge/detail
GET/case/knowledge/document
POST/case/knowledge/category/add
PATCH/case/knowledge/category/update
DELETE/case/knowledge/category/delete
POST/case/knowledge/article/add
PATCH/case/knowledge/article/update
DELETE/case/knowledge/article/delete
POST/case/knowledge/document/add
DELETE/case/knowledge/document/delete
Verified coverage The public catalogue matches all 64 case/* routes actually available in the SellViaApp API.
Snel starten
Authenticate, choose a route, test.
Get the X-API-Key and generate the Bearer in Dashboard → API. Enter them below, then use “Test · Generate” on an endpoint to obtain the response and cURL, PHP 8 or JavaScript code.
Credentials incompleteEnter the X-API-Key and Bearer token to prepare a test.
Credentials remain in memory for this page only. For a customer-related operation, add customer_id.
Keep in mindHTTPS + JSON · keep both credentials server-side · never send tokens to support.
ERP ↔ SellViaApp
Your ERP can drive the complete mobile experience.
The API is not limited to retrieving cases. Your software can configure the module, supply the data used by the app, assign technicians and retrieve actions completed in the field or by customers.
From your ERP to the app
Organise and send work
Intervention types, forms, customers, technicians, cases, appointments, missions, checklists, documents, quotes, recurring work and knowledge base.
From the app to your ERP
Retrieve real activity
Customer requests, statuses, progress, messages, photos, documents, completed steps, time entries, quote decisions, approvals and signatures.
Controlled synchronisation
Keep one business workflow
Your ERP stores the identifiers returned by SellViaApp, retrieves cases and related data, then applies only relevant changes to your system.
- 1ConnectUse the X-API-Key and Bearer generated in Dashboard → API.
- 2ConfigureCreate the required types, forms, technicians, checklists and technical content.
- 3OperateCreate or update cases, then assign interventions.
- 4SynchroniseRetrieve cases, messages, documents, time entries and approvals needed by your ERP.
Developer tipStart with Cases and lifecycle, then add the business categories your ERP actually needs. Every endpoint can be tested and generates ready-to-copy code.
Eindpunten
Cases and lifecycle
Create, search, retrieve and update a case: status, priority, progress, appointments, assignment and technician mission.
5 routes ⌄
Eindpunten
Cases and lifecycle
Create, search, retrieve and update a case: status, priority, progress, appointments, assignment and technician mission.
/case/list
Sleutel + drager
List the signed-in customer cases; a supplier token can list every case.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
page
geheel getal
Optional
Paginanummer, vanaf 1.
per_page
geheel getal
Optional
Number of results per page.
customer_id
geheel getal
Optional
Required only with an integration token when the operation targets a specific customer.
status
tekenreeks
Optional
Filter by status code.
type_id
geheel getal
Optional
Filter by intervention type.
priority
enum
Optional
low | normal | high | urgent
q
tekenreeks
Optional
Supplier search by reference, title, description or assignee.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 123,
"reference": "DOS-260825-A1B2C3",
"customer_id": 42,
"type_id": 3,
"type_name": "Maintenance",
"title": "Contrôle équipement",
"status_code": "planned",
"priority": "normal",
"progress_percent": 25,
"technician_id": 18,
"appointment_start": "2026-08-27 08:30:00",
"updated_at": "2026-08-25 09:15:00"
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"pages": 1
}
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/detail
Sleutel + drager
Retrieve a case with timeline, messages, documents and detailed quotes. The private mission is returned only to the assigned technician and supplier.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Case identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"reference": "DOS-260825-A1B2C3",
"customer_id": 42,
"type_id": 3,
"title": "Contrôle équipement",
"status_code": "planned",
"priority": "normal",
"progress_percent": 25,
"technician_id": 18,
"custom_fields": [],
"events": [],
"messages": [],
"documents": [],
"quotes": [],
"validations": []
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/create
Sleutel + drager
Create a service request linked to the customer.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
customer_id
geheel getal
Optional
Required only with a supplier token.
type_id
geheel getal
Optional
Active intervention type.
title
tekenreeks
Vereist
Short request title.
description
tekenreeks
Vereist
Problem or request description.
status
tekenreeks
Optional
Supplier only; defaults to new.
priority
enum
Optional
low | normal | high | urgent
progress
geheel getal
Optional
0 - 100
address
tekenreeks
Optional
Service address.
appointment_start
datetime
Optional
YYYY-MM-DD HH:MM:SS
appointment_end
datetime
Optional
YYYY-MM-DD HH:MM:SS
assigned_to
tekenreeks
Optional
Assigned person or team.
technician_id
geheel getal
Optional
Assigned technician; supplier only.
custom_fields
object
Optional
Values indexed by custom field ID or key.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"reference": "DOS-260825-A1B2C3",
"status": "new",
"progress": 0
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/update
Sleutel + drager
Update customer, type, status, priority, progress, appointment and assignment.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Case identifier.
customer_id
geheel getal
Optional
Linked customer; 0 removes the link.
type_id
geheel getal
Optional
Type; 0 removes the type.
title
tekenreeks
Optional
Case title.
description
tekenreeks
Optional
Detailed description.
status
tekenreeks
Optional
Code returned by case/status/list.
priority
enum
Optional
low | normal | high | urgent
progress
geheel getal
Optional
0 - 100
address
tekenreeks
Optional
Service address.
appointment_start
datetime
Optional
Empty to clear the date.
appointment_end
datetime
Optional
Empty to clear the date.
assigned_to
tekenreeks
Optional
Assigned person or team.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "in_progress",
"progress": 50,
"technician_id": 18
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/status/list
Sleutel + drager
List workflow statuses and their translated labels.
Input
URL queryAvailable parameters
No business parameter is expected. Send only the indicated authentication headers.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"code": "in_progress",
"label_fr": "En cours",
"label_en": "In progress",
"color": "#2563eb",
"sort_order": 30,
"is_closed": false
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Types and forms
Let the ERP manage intervention types and custom fields requested in the mobile app.
8 routes ⌄
Eindpunten
Types and forms
Let the ERP manage intervention types and custom fields requested in the mobile app.
/case/type/list
Sleutel + drager
List available intervention types.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
include_inactive
booleaans
Optional
Supplier only; includes hidden types.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 3,
"name": "Maintenance",
"description": "Intervention de maintenance",
"active": true,
"sort_order": 10,
"case_count": 8
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/type/add
Sleutel + drager
Create an intervention type.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
name
tekenreeks
Vereist
Type name.
description
tekenreeks
Optional
Maximum 2,000 characters.
sort_order
geheel getal
Optional
Display order.
active
booleaans
Optional
Active by default.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/type/update
Sleutel + drager
Edit, reorder or hide an intervention type.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Type identifier.
name
tekenreeks
Vereist
Type name.
description
tekenreeks
Optional
Description.
sort_order
geheel getal
Optional
Display order.
active
booleaans
Optional
Type availability.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/type/delete
Sleutel + drager
Delete an unused type or archive a linked type.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
A type in use will be archived.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/form/list
Sleutel + drager
List custom service-request fields.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
type_id
geheel getal
Optional
Limit to global fields and the selected type.
include_inactive
booleaans
Optional
Supplier only.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 7,
"type_id": 3,
"field_key": "serial_number_a1b2c3",
"label_fr": "Numéro de série",
"label_en": "Serial number",
"field_type": "text",
"required": true,
"active": true,
"options": []
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/form/add
Sleutel + drager
Add information to request from customers.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
type_id
geheel getal
Optional
0 or omitted for every type.
label_fr
tekenreeks
Vereist
French label.
label_en
tekenreeks
Optional
English label.
field_type
enum
Vereist
text | textarea | select | boolean | date | number
options
array
Optional
Required for select.
required
booleaans
Optional
Required answer.
sort_order
geheel getal
Optional
Display order.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/form/update
Sleutel + drager
Update a custom request field.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Field identifier.
type_id
geheel getal
Optional
Linked type or 0.
label_fr
tekenreeks
Vereist
French label.
label_en
tekenreeks
Optional
English label.
field_type
enum
Vereist
text | textarea | select | boolean | date | number
options
array
Optional
Menu options.
required
booleaans
Optional
Required answer.
active
booleaans
Optional
Visible field.
sort_order
geheel getal
Optional
Order.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/form/delete
Sleutel + drager
Delete or archive a custom request field.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Field identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Technicians and assignments
Synchronise field teams, skills and roles, then assign every intervention to the right technician.
5 routes ⌄
Eindpunten
Technicians and assignments
Synchronise field teams, skills and roles, then assign every intervention to the right technician.
/case/technician/list
Sleutel + drager
List technicians separately with job, skills, availability and workload.
Input
URL queryAvailable parameters
No business parameter is expected. Send only the indicated authentication headers.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 18,
"prenom": "Alex",
"nom": "Martin",
"mobile_role": "technician",
"employee_code": "TECH-018",
"job_title": "Technicien terrain",
"skills": "Maintenance",
"active": true,
"case_count": 12,
"active_case_count": 3
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/technician/detail
Sleutel + drager
Retrieve a technician’s complete professional record.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
technician_id
geheel getal
Vereist
Technician identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 18,
"prenom": "Alex",
"nom": "Martin",
"mobile_role": "technician",
"employee_code": "TECH-018",
"job_title": "Technicien terrain",
"specialties": "Entretien préventif",
"skills": "Diagnostic, maintenance",
"service_area": "Bruxelles",
"emergency_available": true,
"active": true
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/technician/profile
Sleutel + drager
Create or update a technician account’s professional profile.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
technician_id
geheel getal
Vereist
Mobile account to configure as technician.
employee_code
tekenreeks
Optional
Employee or internal code.
job_title
tekenreeks
Optional
Technician job title.
specialties
tekenreeks
Optional
Field specialities.
skills
tekenreeks
Optional
Skills and certifications.
service_area
tekenreeks
Optional
Service area.
availability_notes
tekenreeks
Optional
Usual availability.
emergency_available
booleaans
Optional
Available for emergencies.
internal_notes
tekenreeks
Optional
Internal notes hidden in the app.
profile_color
tekenreeks
Optional
#RRGGBB
active
booleaans
Optional
Active technician.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/technician/role
Sleutel + drager
Assign the Customer or Technician role to a mobile account.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
customer_id
geheel getal
Vereist
Mobile account.
role
enum
Vereist
client | technician
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/technician/update
Sleutel + drager
Allow the assigned technician to update status and progress.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Service assigned to the signed-in technician.
status
enum
Vereist
planned | in_progress | waiting_customer | completed
progress
geheel getal
Optional
0 - 100
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "in_progress",
"progress": 50,
"technician_id": 18
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Missions and checklists
Prepare procedures, retrieve applied steps and record field completion.
7 routes ⌄
Eindpunten
Missions and checklists
Prepare procedures, retrieve applied steps and record field completion.
/case/checklist/list
Sleutel + drager
Retrieve the checklist and progress for an authorised case.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case authorised for the signed-in account.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"case_id": 123,
"mission_note": "Contrôler puis photographier l’équipement.",
"items": [
{
"id": 301,
"label_fr": "Contrôle visuel",
"label_en": "Visual inspection",
"required": true,
"completed": false,
"note": "",
"documents": []
}
],
"progress": {
"completed": 0,
"total": 1,
"percent": 0
}
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/mission/update
Sleutel + drager
Set the private mission visible only to the assigned technician.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case whose mission is being set.
mission_note
tekenreeks
Optional
Private technician instruction, maximum 10,000 characters. An empty value clears the mission.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/checklist/item/update
Sleutel + drager
Complete or reopen a step; assigned technician or supplier only.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case assigned to the technician.
item_id
geheel getal
Vereist
Checklist step.
completed
booleaans
Vereist
Complete or reopen the step.
note
tekenreeks
Optional
Optional field note.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"case_id": 123,
"mission_note": "Contrôler puis photographier l’équipement.",
"items": [
{
"id": 301,
"label_fr": "Contrôle visuel",
"label_en": "Visual inspection",
"required": true,
"completed": false,
"note": "",
"documents": []
}
],
"progress": {
"completed": 0,
"total": 1,
"percent": 0
}
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/checklist/template/list
Sleutel + drager
List checklist templates and their steps.
Input
URL queryAvailable parameters
No business parameter is expected. Send only the indicated authentication headers.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 9,
"type_id": 3,
"title_fr": "Maintenance standard",
"title_en": "Standard maintenance",
"active": true,
"items": [
{
"id": 91,
"label_fr": "Contrôle visuel",
"required": true,
"sort_order": 10
}
]
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/checklist/template/add
Sleutel + drager
Create a global checklist or one linked to an intervention type.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
type_id
geheel getal
Optional
Omit or use 0 for every type.
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title.
items
array
Vereist
Steps as strings or objects with label_fr, label_en, required and sort_order.
active
booleaans
Optional
Active by default.
sort_order
geheel getal
Optional
Template order.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/checklist/template/update
Sleutel + drager
Update a template and safely replace its steps.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Template identifier.
type_id
geheel getal
Optional
Linked type or 0.
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title.
items
array
Vereist
Complete list replacing template steps.
active
booleaans
Optional
Availability.
sort_order
geheel getal
Optional
Order.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/checklist/template/delete
Sleutel + drager
Delete an unused template or archive an applied template.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
An applied template will be archived.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Time tracking
Start, stop, add and audit technician time for every case.
5 routes ⌄
Eindpunten
Time tracking
Start, stop, add and audit technician time for every case.
/case/time/list
Sleutel + drager
List time entries and total tracked time for an authorised case.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case assigned to the technician; supplier access is read-only.
technician_id
geheel getal
Optional
Supplier access only; assigned technician by default.
include_deleted
booleaans
Optional
Supplier access only; include deleted entries and their reason.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 77,
"case_id": 123,
"technician_id": 18,
"started_at": "2026-08-25 08:00:00",
"ended_at": "2026-08-25 09:30:00",
"duration_seconds": 5400,
"note": "Intervention sur site",
"deleted_at": null
}
],
"total_seconds": 5400
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/time/start
Sleutel + drager
Start a live timer for the assigned technician.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case assigned to the signed-in technician.
note
tekenreeks
Optional
Optional note, maximum 1,000 characters.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/time/stop
Sleutel + drager
Stop and calculate the active time entry.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case containing the active time entry.
entry_id
geheel getal
Optional
Active entry; the current case entry is used when omitted.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/time/add
Sleutel + drager
Manually add a date, start time and end time.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case assigned to the signed-in technician.
started_at
datetime
Vereist
ISO 8601 date and time with timezone.
ended_at
datetime
Vereist
After started_at; duration from 1 minute to 48 hours, without overlap.
note
tekenreeks
Optional
Optional note.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/time/delete
Sleutel + drager
Soft-delete a time entry with a mandatory reason retained in the audit trail.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
entry_id
geheel getal
Vereist
Completed entry belonging to the technician.
reason
tekenreeks
Vereist
Mandatory reason from 5 to 1,000 characters.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Messages, photos and documents
Exchange data with the app, classify documents, send photos and retrieve authorised files.
10 routes ⌄
Eindpunten
Messages, photos and documents
Exchange data with the app, classify documents, send photos and retrieve authorised files.
/case/message/send
Sleutel + drager
Add a message to the case; the sender is identified automatically from the authenticated account.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case identifier.
message
tekenreeks
Vereist
Message to add.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document-type/list
Sleutel + drager
List document types visible in the mobile app.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
include_inactive
booleaans
Optional
Supplier token only; includes archived types.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 4,
"label_fr": "Rapport",
"label_en": "Report",
"icon": "description",
"color": "#2563eb",
"active": true,
"sort_order": 10,
"document_count": 6
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document-type/add
Sleutel + drager
Create a document type for the shop.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
label_fr
tekenreeks
Vereist
French type name.
label_en
tekenreeks
Optional
English name; falls back to French.
icon
enum
Optional
description | photo_camera | assignment | request_quote | receipt_long | verified | folder | build
color
hex
Optional
#RRGGBB
sort_order
geheel getal
Optional
Display order.
active
booleaans
Optional
Active by default.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document-type/update
Sleutel + drager
Edit, reorder or hide a document type.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Type identifier.
label_fr
tekenreeks
Vereist
French type name.
label_en
tekenreeks
Optional
English name.
icon
enum
Optional
description | photo_camera | assignment | request_quote | receipt_long | verified | folder | build
color
hex
Optional
#RRGGBB
sort_order
geheel getal
Optional
Display order.
active
booleaans
Optional
Type availability.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document-type/delete
Sleutel + drager
Delete an unused type or archive a type already in use.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Type identifier. A type in use will be archived.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document/list
Sleutel + drager
List all authorised documents newest first with their customer, technician or administrator source.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
page
geheel getal
Optional
Paginanummer, vanaf 1.
per_page
geheel getal
Optional
Number of results per page.
customer_id
geheel getal
Optional
Supplier-only filter.
case_id
geheel getal
Optional
Limit to one case.
unlinked_only
booleaans
Optional
Return only documents not linked to a case.
document_type_id
geheel getal
Optional
Limit to one document type.
folder_path
tekenreeks
Optional
Limit to an exact path, for example Reports / 2026.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 88,
"case_id": 123,
"document_type_id": 4,
"title": "Rapport terrain",
"folder_path": "Rapports / 2026",
"kind": "document",
"file_name": "rapport.pdf",
"mime_type": "application/pdf",
"file_size": 245760,
"uploaded_by_type": "technician",
"origin_type": "technician",
"customer_visible": true,
"created_at": "2026-08-25 09:30:00"
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 1,
"pages": 1
}
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document/add
Sleutel + drager
Add one or more photos, PDFs, documents or signatures, optionally linked to a checklist step.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Optional
Optional case. Required when checklist_item_id is provided.
customer_id
geheel getal
Optional
Required with a supplier token when case_id is absent; ignored for an authenticated customer.
document_type_id
geheel getal
Optional
Classification type; an active default is used when omitted.
checklist_item_id
geheel getal
Optional
Checklist step that must belong to the specified case. Repeat the call to link multiple files.
title
tekenreeks
Optional
Readable title; falls back to the file name.
folder_path
tekenreeks
Optional
Free folder structure separated by /, maximum 8 levels.
note
tekenreeks
Optional
Optional note, maximum 5,000 characters.
customer_visible
booleaans
Optional
A supplier token can keep the document internal with false; mobile uploads remain visible.
kind
enum
Optional
photo | document | signature
photo_stage
enum
Optional
general | before | after
file_name
tekenreeks
Vereist
File name.
mime_type
enum
Vereist
image/jpeg | image/png | image/webp | application/pdf
content_base64
base64
Vereist
Encoded file, maximum 6 MB.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document/get
Sleutel + drager
Download the Base64 content of an authorised document.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Document identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 88,
"case_id": 123,
"title": "Rapport terrain",
"kind": "document",
"file_name": "rapport.pdf",
"mime_type": "application/pdf",
"file_size": 245760,
"origin_type": "technician",
"customer_visible": true,
"content_base64": "JVBERi0xLjQ…"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document/preview
Sleutel + drager
Load an optimised image thumbnail before opening and zooming.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Authorised image-document identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 89,
"mime_type": "image/jpeg",
"content_base64": "/9j/4AAQSkZJRg…"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/document/delete
Sleutel + drager
Delete a document that is not attached to a quote.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Document identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Quotes, approval and signature
Create detailed quotes, retrieve customer decisions and manage final intervention approval.
4 routes ⌄
Eindpunten
Quotes, approval and signature
Create detailed quotes, retrieve customer decisions and manage final intervention approval.
/case/quote/create
Sleutel + drager
Create and send a detailed quote with lines, discounts, VAT and an optional attachment.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case identifier.
lines
array
Vereist
1 to 100 objects: description, quantity, unit_price, discount_percent and tax_rate.
notes
tekenreeks
Optional
Maximum 5,000 characters.
valid_until
datum
Optional
JJJJ-MM-DD
attachment
object
Optional
file_name, mime_type and content_base64; maximum 6 MB.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 41,
"case_id": 123,
"quote_number": "DEV-20260825-0123-A1B2",
"status": "sent",
"subtotal": 100,
"discount_total": 0,
"tax_total": 21,
"total": 121,
"currency": "EUR",
"customer_id": 42
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/quote/respond
Sleutel + drager
Accept or reject a quote sent to the customer.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case identifier.
quote_id
geheel getal
Vereist
Quote identifier.
decision
enum
Vereist
accepted | rejected
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"quote_id": 41,
"status": "accepted"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/validation/request
Sleutel + drager
Request customer approval and signature.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case identifier.
validation_type
tekenreeks
Optional
Defaults to completion.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 63,
"case_id": 123,
"status": "pending",
"created": true
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/validation/send
Sleutel + drager
Record the customer signature, either directly by the customer or on the assigned technician’s phone.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Case identifier accessible to the customer or assigned technician.
validation_type
tekenreeks
Optional
Defaults to completion.
signature_name
tekenreeks
Vereist
Name of the customer signing.
signature_base64
base64
Vereist
PNG signature image encoded as Base64.
comment
tekenreeks
Optional
Optional customer comment.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 63,
"captured_by_type": "technician"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Planning, recurrence and reports
Automate recurring interventions and produce structured final-report data.
6 routes ⌄
Eindpunten
Planning, recurrence and reports
Automate recurring interventions and produce structured final-report data.
/case/recurrence/list
Sleutel + drager
List recurring services.
Input
URL queryAvailable parameters
No business parameter is expected. Send only the indicated authentication headers.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 12,
"source_case_id": 123,
"frequency": "monthly",
"interval_value": 1,
"next_run_at": "2026-09-25 08:00:00",
"end_at": null,
"active": true
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/recurrence/add
Sleutel + drager
Create a recurrence from a source case.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
source_case_id
geheel getal
Vereist
Case used as the template.
frequency
enum
Vereist
daily | weekly | monthly | yearly
interval_value
geheel getal
Optional
1 - 52
next_run_at
datetime
Vereist
YYYY-MM-DD HH:MM:SS
end_at
datetime
Optional
Optional end date.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/recurrence/update
Sleutel + drager
Update a recurring service.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Recurrence identifier.
source_case_id
geheel getal
Vereist
Source case.
frequency
enum
Vereist
daily | weekly | monthly | yearly
interval_value
geheel getal
Optional
1 - 52
next_run_at
datetime
Vereist
YYYY-MM-DD HH:MM:SS
end_at
datetime
Optional
Optional end date.
active
booleaans
Optional
Active recurrence.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/recurrence/delete
Sleutel + drager
Stop a recurring service.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Recurrence identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/recurrence/process
Sleutel + drager
Generate recurring services that are due.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
limit
geheel getal
Optional
Maximum 200 creations per call.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"created": [
{
"id": 124,
"reference": "DOS-260925-D4E5F6",
"recurrence_id": 12
}
],
"count": 1
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/report/summary
Sleutel + drager
Prepare the final report with fields and before/after photos.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
case_id
geheel getal
Vereist
Report case.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"case": {
"id": 123,
"reference": "DOS-260825-A1B2C3",
"title": "Contrôle équipement"
},
"custom_fields": [],
"photos": {
"before": [],
"after": [],
"general": []
},
"comparison_ready": false
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Kennisgevingen
Retrieve customer or technician alerts and synchronise their read status.
2 routes ⌄
Eindpunten
Kennisgevingen
Retrieve customer or technician alerts and synchronise their read status.
/case/notification/list
Sleutel + drager
List automatic notifications for the signed-in customer or technician.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
limit
geheel getal
Optional
1 - 100
recipient_type
enum
Optional
Supplier token only: customer or technician.
recipient_id
geheel getal
Optional
Supplier token only.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 501,
"case_id": 123,
"event_key": "case.assigned",
"title_fr": "Nouveau dossier attribué",
"message_fr": "Une intervention vous a été attribuée.",
"read": false,
"created_at": "2026-08-25 09:15:00"
}
],
"unread_count": 1
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/notification/read
Sleutel + drager
Mark one or every notification as read.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Optional
Omit to mark all notifications as read.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Eindpunten
Knowledge base
Supply procedures, FAQs and technical documents available to technicians in the mobile app.
12 routes ⌄
Eindpunten
Knowledge base
Supply procedures, FAQs and technical documents available to technicians in the mobile app.
/case/knowledge/categories
Sleutel + drager
List knowledge-base categories. On mobile, access is restricted to active technicians.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
include_inactive
booleaans
Optional
Supplier token only.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 6,
"title_fr": "Procédures",
"title_en": "Procedures",
"color": "#2563eb",
"active": true,
"sort_order": 10,
"article_count": 4
}
]
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/search
Sleutel + drager
Quickly search FAQs, information, procedures and documents by keyword. Mobile access is technician-only.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
q
tekenreeks
Optional
Keyword or phrase, maximum 120 characters.
category_id
geheel getal
Optional
Filter by category.
type
enum
Optional
faq | information | procedure | document
page
geheel getal
Optional
Page, defaults to 1.
limit
geheel getal
Optional
1 to 50 results.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"items": [
{
"id": 31,
"category_id": 6,
"content_type": "procedure",
"title_fr": "Redémarrer l’équipement",
"summary_fr": "Procédure de contrôle.",
"keywords": "redémarrage, contrôle",
"featured": true,
"document_count": 1
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"pages": 1
}
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/detail
Sleutel + drager
Open an entry and list its attachments without loading large files.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Entry identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 31,
"category_id": 6,
"content_type": "procedure",
"title_fr": "Redémarrer l’équipement",
"content_fr": "Suivez les étapes de sécurité.",
"featured": true,
"active": true,
"documents": []
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/document
Sleutel + drager
Download an authorised Base64 attachment.
Input
URL queryAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Attachment identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 15,
"article_id": 31,
"file_name": "procedure.pdf",
"mime_type": "application/pdf",
"file_size": 184320,
"content_base64": "JVBERi0xLjQ…"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/category/add
Sleutel + drager
Create a knowledge category.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title with French fallback.
description_fr
tekenreeks
Optional
French description.
description_en
tekenreeks
Optional
English description.
color
hex
Optional
#RRGGBB
active
booleaans
Optional
Visible by default.
sort_order
geheel getal
Optional
Order.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/category/update
Sleutel + drager
Edit, reorder or hide a category.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Category identifier.
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title.
active
booleaans
Optional
Visibility.
sort_order
geheel getal
Optional
Order.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/category/delete
Sleutel + drager
Delete a category while retaining its entries as uncategorised.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Category identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/article/add
Sleutel + drager
Create a FAQ, information entry, procedure or documentation.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
category_id
geheel getal
Optional
Optional category.
content_type
enum
Vereist
faq | information | procedure | document
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title.
summary_fr
tekenreeks
Optional
French summary.
summary_en
tekenreeks
Optional
English summary.
content_fr
tekenreeks
Optional
French content.
content_en
tekenreeks
Optional
English content.
keywords
tekenreeks
Optional
Comma-separated keywords.
featured
booleaans
Optional
Featured.
active
booleaans
Optional
Published.
sort_order
geheel getal
Optional
Order.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/article/update
Sleutel + drager
Edit and publish an entry.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Entry identifier.
content_type
enum
Vereist
faq | information | procedure | document
title_fr
tekenreeks
Vereist
French title.
title_en
tekenreeks
Optional
English title.
content_fr
tekenreeks
Optional
French content.
content_en
tekenreeks
Optional
English content.
active
booleaans
Optional
Published.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/article/delete
Sleutel + drager
Delete an entry and its attachments.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Entry identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/document/add
Sleutel + drager
Attach a document up to 8 MB.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
article_id
geheel getal
Vereist
Parent entry.
title_fr
tekenreeks
Optional
French title.
title_en
tekenreeks
Optional
English title.
file_name
tekenreeks
Vereist
File name.
mime_type
tekenreeks
Vereist
Allowed MIME type.
content_base64
base64
Vereist
Maximum 8 MB.
Output
Possible results
201Resource created
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}/case/knowledge/document/delete
Sleutel + drager
Delete an attachment.
Input
JSON-bodyAvailable parameters
NaamTypeRequirementOmschrijving
id
geheel getal
Vereist
Attachment identifier.
Output
Possible results
200Successful operation
400Invalid request or JSON
401Missing or invalid authentication
403Insufficient access
404Requested resource not found
409Conflict with existing data
422Parameter rejected by validation
429Request limit reached
5xxTemporary technical incident
Success example
{
"success": true,
"message": "Operation successful",
"data": {
"id": 123,
"status": "ok"
},
"error": null
}Error example
{
"success": false,
"message": "The request cannot be processed.",
"data": null,
"error": {
"code": "VALIDATION_ERROR",
"category": "validation",
"message": "Check the indicated parameters.",
"details": {
"field": "parameter_name"
}
}
}Geen eindpunt komt overeen met uw zoekopdracht.
Reference
Responses and errors
Each row has a “Parameters and responses” button showing required or optional fields, possible statuses and JSON examples. An empty list means the resource is not populated yet, not that the endpoint is down.
400Ongeldig verzoek
401Aanmelding vereist
403Toegang geweigerd
404Hulpbron of route niet gevonden
409Bedrijfsconflict
422Validatie mislukt
429Te veel verzoeken
5xxTechnisch incident