Tecaser API (0.14.204)

Download OpenAPI specification:

This API allows users to access Tecaser API!

Comments - Command

Comment command operations on any resource

Delete a comment (soft delete)

Soft deletes a comment. The comment is marked as deleted but not physically removed.

Authorization: Only the comment author can delete their comment.

Deleted comments:

  • Remain in database with deleted=true flag
  • Full history preserved in event store
  • Can be viewed by admins with includeDeleted=true query param
  • After 5 years, may be physically deleted by scheduled job

GDPR Exception: If your organisation is deleted, all comments are immediately physically deleted regardless of the 5-year retention period.

Behavior:

  • Returns 204 No Content on success
  • Requires version number for optimistic locking
  • Cannot delete already-deleted comments (404)

Business Rules:

  • Version number required in query parameter
  • Comment must not be already deleted
  • Comment must belong to your organisation
  • Only comment author can delete
Authorizations:
None
path Parameters
required
object (CommentId)

Comment ID

query Parameters
version
required
integer <int64>

Current version of the comment for optimistic locking

header Parameters
required
object (OrganisationId)

Organisation UUID from header

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Edit a comment

Edits an existing comment's content.

Authorization: Only the comment author can edit their comment.

Behavior:

  • Updates comment content with event sourcing (edit history preserved)
  • Returns 200 OK with Location header pointing to updated comment
  • Requires current version number for optimistic locking

Optimistic Locking: If the comment was modified by another user since you last fetched it:

  • You'll receive 409 Conflict
  • Response includes current version number
  • Re-fetch the comment to get latest version
  • Retry your edit with new version number

Business Rules:

  • Content: 1-10,000 characters (plain text only)
  • Cannot edit deleted comments (returns 404)
  • Version number is required for optimistic locking
  • All edits are tracked in event history
  • Only comment author can edit
Authorizations:
None
path Parameters
required
object (CommentId)

Comment ID

header Parameters
required
object (OrganisationId)

Organisation UUID from header

Request Body schema: application/json
required
content
required
string [ 1 .. 10000 ] characters

Updated comment text content

version
required
integer <int64>

Current version number for optimistic locking (prevents concurrent modification conflicts)

Responses

Request samples

Content type
application/json
{
  • "content": "Updated: Authentication now uses OAuth2 with PKCE extension for enhanced security",
  • "version": 2
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Add a comment to any resource

Adds a new comment to any resource (task, vehicle, maintenance order, fuel record, etc.).

Behavior:

  • Creates new comment with event sourcing (immutable audit trail)
  • Returns 201 Created with Location header pointing to the created comment
  • You MUST follow the Location header to retrieve the full comment details

Business Rules:

  • Content is required (1-10,000 characters, plain text only)
  • Author is set to authenticated user (immutable)
  • Parent resource must exist and belong to your organisation
  • You must have access to the parent resource

Context Types:

  • task: Kanban task
  • vehicle: Fleet vehicle
  • maintenance-order: Maintenance work order
  • fuel-record: Fuel refueling record

Workflow:

  1. Send POST request with comment content
  2. Receive 201 Created response with Location header
  3. Follow Location header to GET full comment representation
  4. Use HATEOAS links in response to perform next actions (edit, delete)
Authorizations:
None
path Parameters
contextType
required
string (ContextType)
Enum: "task" "vehicle" "maintenance-order" "fuel-record" "task" "vehicle" "maintenance-order" "fuel-record"
Example: task

Type of parent resource

required
object (ContextId)
Example: 660e8400-e29b-41d4-a716-446655440000

Parent resource identifier

header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Request Body schema: application/json
required
content
required
string [ 1 .. 10000 ] characters

Comment text content (plain text only)

Responses

Request samples

Content type
application/json
{
  • "content": "Updated the authentication logic to use OAuth2 with refresh token rotation"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Kanban - Commands

Task command operations

Create a new task Deprecated

Creates a new task in your organisation's Kanban board.

Behavior:

  • Task is assigned a sequential task number starting from 1 per organisation
  • If status is not provided, task defaults to BACKLOG
  • Returns 200 OK with Location header pointing to the created task
  • You MUST follow the Location header to retrieve the full task details

Business Rules:

  • Title is required (1-500 characters)
  • Description is optional
  • Assigned user must exist in your organisation (if provided)
  • Status must be one of: BACKLOG, TO_DO, IN_PROGRESS, DONE, CLOSED, CANCELLED
  • Flagged defaults to false if not provided

Workflow:

  1. Send POST request with task details
  2. Receive 200 Ok response with Location header
  3. Follow Location header to GET full task representation
  4. Use HATEOAS links in response to perform next actions
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Request Body schema: application/json
required
assignedUserId
string <uuid>

UUID of user to assign this task to.

Constraints:

  • Optional (task can be unassigned)
  • User must exist in your organisation
  • If user is deleted, assignment is cleared (ON DELETE SET NULL)

Use case: Assign tasks to team members for clear ownership

description
string [ 0 .. 10000 ] characters

Detailed task description (optional).

Provide additional context, requirements, acceptance criteria, or any other information that helps understand what needs to be done.

Constraints:

  • Optional
  • Maximum length: 10,000 characters

Formatting: Plain text or markdown

flagged
boolean

Flag indicating if task is marked as important/priority.

Purpose: Similar to starring/flagging emails - marks tasks that need special attention.

Default: false (new tasks are not flagged)

Visual representation: Often shown as a star or flag icon in UI

status
string (TaskStatus)
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED" "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CANCELLED"

Current status of the task in the Kanban workflow.

Available statuses:

  • BACKLOG: Task is planned but not yet ready
  • TO_DO: Task is ready to be picked up
  • IN_PROGRESS: Currently being worked on
  • DONE: Task is completed
  • CANCELLED: Task was cancelled
title
required
string [ 1 .. 500 ] characters

Task title. Brief description of what needs to be done.

Constraints:

  • Required for task creation
  • Minimum length: 1 character
  • Maximum length: 500 characters
  • Cannot be blank (only whitespace)

Examples:

  • "Implement OAuth2 authentication"
  • "Fix memory leak in user service"
  • "Update API documentation for v2.0"

Responses

Request samples

Content type
application/json
{
  • "assignedUserId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  • "description": "Add OAuth2 authentication with Google and GitHub providers. Include refresh token rotation and session management.",
  • "flagged": true,
  • "status": "IN_PROGRESS",
  • "title": "Implement user authentication"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Delete is moving task to CANCELED Deprecated

Move task to canceled. The task is marked as CANCELED but not physically removed.

CANCELED tasks:

  • After 5 years, a scheduled job physically deletes the task and its events

GDPR Exception: If your organisation is deleted, all tasks are immediately physically deleted regardless of the 5-year retention period.

Behavior:

  • Returns 204 No Content on success
  • Requires version number for optimistic locking
  • Cannot delete already-deleted tasks (404)

Business Rules:

  • Version number required in query parameter
  • Task must not be already deleted
  • Task must belong to your organisation

Recovery: CANCELED tasks can be undeleted by moving to other state.

path Parameters
taskId
required
string <uuid>

Task ID

query Parameters
version
required
integer <int64>

Current version of the task for optimistic locking

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Update task properties Deprecated

Updates task properties: title, description, assignedUserId, and flagged status.

Important: This endpoint CANNOT change task status or position. Use PUT /api/v0.1/kanban/task/{id}/move to change status or position.

Behavior:

  • Returns 200 OK with Location header pointing to updated task
  • Follow Location header to GET updated task with new HATEOAS links
  • Requires current version number for optimistic locking

Optimistic Locking: If the task was modified by another user since you last fetched it:

  • You'll receive 409 Conflict
  • Response includes current version number
  • Re-fetch the task with GET to get latest version
  • Retry your update with new version number

Business Rules:

  • Title: 1-500 characters
  • Description: max 10,000 characters
  • Assigned user must exist in your organisation
  • Cannot update soft-deleted tasks
  • Cannot change status or position via this endpoint (returns 400)
path Parameters
taskId
required
string <uuid>

Task ID

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
assignedUserId
string <uuid>

New assigned user UUID (optional - only if you want to change assignment).

Constraints:

  • User must exist in your organisation

Omit this field if you don't want to change the assignment. Set to null to unassign the task.

description
string [ 0 .. 10000 ] characters

New task description (optional - only if you want to change it).

Constraints:

  • Maximum length: 10,000 characters

Omit this field if you don't want to change the description. Set to empty string to clear the description.

flagged
required
boolean

New flagged status (optional - only if you want to toggle the flag).

Omit this field if you don't want to change the flagged status. Set to true to flag the task as important. Set to false to unflag the task.

title
required
string [ 1 .. 500 ] characters

New task title (optional - only if you want to change it).

Constraints:

  • Minimum length: 1 character
  • Maximum length: 500 characters
  • Cannot be blank (only whitespace)

Omit this field if you don't want to change the title.

version
required
integer <int64> >= 1

Current version number for optimistic locking.

How it works:

  • Get this from the task's version field when you last fetched it
  • If another user modified the task since then, you'll receive 409 Conflict
  • Re-fetch the task and retry with new version number

Required: This field is mandatory for all update operations

Example: If the task's current version is 5, provide 5 here. If successful, the task will be updated to version 6.

Responses

Request samples

Content type
application/json
{
  • "assignedUserId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  • "description": "Add OAuth2 with Google, GitHub, and Microsoft providers. Implement MFA support.",
  • "flagged": true,
  • "title": "Implement OAuth2 authentication with MFA",
  • "version": 5
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Move task to different status and/or position Deprecated

Moves a task to a different status column and/or changes its position within a status.

This is the ONLY endpoint that can change task status and position.

Behavior:

  • Returns 200 Ok with Location header pointing to moved task
  • If newPosition is null/omitted -> task moves to end of target status
  • If newPosition is specified -> task inserted at position, others reordered
  • Requires current version number for optimistic locking
  • ALL tasks in the target status are repositioned and receive updated positions

Position Reordering: When you move a task:

  1. The moved task is inserted at the specified position in target status
  2. ALL tasks in the target status are renumbered sequentially (0, 1, 2, 3...)
  3. This ensures positions remain clean and sequential
  4. Important: ALL tasks in the status column receive KanbanBoardTaskMoved events

Example: Given tasks in IN_PROGRESS: [A(0), B(1), C(2), D(3)] Moving A to position 2 results in: [B(0), C(1), A(2), D(3)]

  • Task A moves to position 2
  • Tasks B, C, D are repositioned to 0, 1, 3 respectively
  • 4 events are emitted (one for each task)

Event Broadcasting: This operation emits KanbanBoardTaskMoved domain events for every task whose position changed. Subscribers (WebSocket, SSE, projection handlers) receive updates for all affected tasks.

Status Transitions: All transitions are allowed between any statuses:

  • BACKLOG <--> TO_DO <--> IN_PROGRESS <--> DONE <--> CLOSED
  • Any status -> CANCELLED
  • DONE/CLOSED/CANCELLED -> any status (reopen workflow)

Typical Workflow:

  • Employee completes work: IN_PROGRESS -> DONE
  • Reviewer approves: DONE -> CLOSED
  • Reviewer requests changes: DONE -> IN_PROGRESS

Business Rules:

  • newStatus is required
  • newPosition must be >= 0 if provided (0-based index)
  • newPosition must be <= current number of tasks in target status
  • Cannot move soft-deleted tasks
  • Version number is required for optimistic locking
  • Positions are always 0-based sequential integers
path Parameters
taskId
required
string <uuid>

Task ID

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
newPosition
integer <int32> >= 0

Target position within the status column (0-based).

Behavior:

  • If omitted (null): Task moves to the end of the target status column
  • If specified: Task is inserted at this position, other tasks shift down

Position Reordering: When you specify a position:

  1. Task is inserted at specified position in target status
  2. Tasks at that position and below are shifted down (+1)
  3. Tasks in source status are shifted up to fill the gap
  4. Positions are always 0-based and sequential

Constraints:

  • Must be >= 0
  • Must be <= current number of tasks in target status
  • Position is unique per (organisation, status) for active tasks

Examples:

  • 0: Move to top of status column
  • 2: Insert at position 2 (third item)
  • null: Move to end of status column
newStatus
required
string (TaskStatus)
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED" "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CANCELLED"

Current status of the task in the Kanban workflow.

Available statuses:

  • BACKLOG: Task is planned but not yet ready
  • TO_DO: Task is ready to be picked up
  • IN_PROGRESS: Currently being worked on
  • DONE: Task is completed
  • CANCELLED: Task was cancelled
version
required
integer <int64> >= 1

Current version number for optimistic locking.

How it works:

  • Get this from the task's version field when you last fetched it
  • If another user moved/modified the task since then, you'll receive 409 Conflict
  • Re-fetch the task and retry with new version number

Required: This field is mandatory for all move operations

Example: If the task's current version is 7, provide 7 here. If successful, the task will be updated to version 8.

Responses

Request samples

Content type
application/json
{
  • "newPosition": 2,
  • "newStatus": "IN_PROGRESS",
  • "version": 7
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Create a new task

Creates a new task in your organisation's Kanban board.

Behavior:

  • Task is assigned a sequential task number starting from 1 per organisation
  • If status is not provided, task defaults to BACKLOG
  • Returns 200 OK with Location header pointing to the created task
  • You MUST follow the Location header to retrieve the full task details

Business Rules:

  • Title is required (1-500 characters)
  • Description is optional
  • Assigned user must exist in your organisation (if provided)
  • Status must be one of: BACKLOG, TO_DO, IN_PROGRESS, DONE, CLOSED, CANCELLED
  • Flagged defaults to false if not provided

Image attachment (optional):

  1. Upload each image via POST /api/v0.1/image with responsibleService: KANBAN_TASK
  2. Collect the returned imageId values
  3. Include them in the imageIds field of this request Images not confirmed via imageIds will be removed by the background housekeeping job.

Workflow:

  1. Send POST request with task details
  2. Receive 200 Ok response with Location header
  3. Follow Location header to GET full task representation
  4. Use HATEOAS links in response to perform next actions
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Request Body schema: application/json
required
assignedUserId
string <uuid>

UUID of user to assign this task to.

Constraints:

  • Optional (task can be unassigned)
  • User must exist in your organisation
  • If user is deleted, assignment is cleared (ON DELETE SET NULL)

Use case: Assign tasks to team members for clear ownership

description
string [ 0 .. 10000 ] characters

Detailed task description (optional).

Provide additional context, requirements, acceptance criteria, or any other information that helps understand what needs to be done.

Constraints:

  • Optional
  • Maximum length: 10,000 characters

Formatting: Plain text or markdown

flagged
boolean

Flag indicating if task is marked as important/priority.

Purpose: Similar to starring/flagging emails - marks tasks that need special attention.

Default: false (new tasks are not flagged)

Visual representation: Often shown as a star or flag icon in UI

imageIds
Array of strings <uuid> [ items <uuid > ]

List of image IDs to attach to this task (optional).

Two-step upload flow:

  1. Upload each image via POST /api/v0.1/image with responsibleService: KANBAN_TASK
  2. Include the returned imageId values in this list

Images uploaded but not included here will be deleted by the background housekeeping job.

status
string (TaskStatus)
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED" "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CANCELLED"

Current status of the task in the Kanban workflow.

Available statuses:

  • BACKLOG: Task is planned but not yet ready
  • TO_DO: Task is ready to be picked up
  • IN_PROGRESS: Currently being worked on
  • DONE: Task is completed
  • CANCELLED: Task was cancelled
title
required
string [ 1 .. 500 ] characters

Task title. Brief description of what needs to be done.

Constraints:

  • Required for task creation
  • Minimum length: 1 character
  • Maximum length: 500 characters
  • Cannot be blank (only whitespace)

Examples:

  • "Implement OAuth2 authentication"
  • "Fix memory leak in user service"
  • "Update API documentation for v2.0"

Responses

Request samples

Content type
application/json
{
  • "assignedUserId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  • "description": "Add OAuth2 authentication with Google and GitHub providers. Include refresh token rotation and session management.",
  • "flagged": true,
  • "imageIds": [
    ],
  • "status": "IN_PROGRESS",
  • "title": "Implement user authentication"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Soft delete - moves task to CANCELLED

Move task to cancelled. The task is marked as CANCELLED but not physically removed.

CANCELLED tasks:

  • After 5 years, a scheduled job physically deletes the task and its events

GDPR Exception: If your organisation is deleted, all tasks are immediately physically deleted regardless of the 5-year retention period.

Behavior:

  • Returns 204 No Content on success
  • Requires version number for optimistic locking
  • Cannot delete already-deleted tasks (404)

Business Rules:

  • Version number required in query parameter
  • Task must not be already deleted
  • Task must belong to your organisation

Recovery: CANCELLED tasks can be undeleted by moving to other state.

path Parameters
taskId
required
string <uuid>

Task ID

query Parameters
version
required
integer <int64>

Current version of the task for optimistic locking

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Update task properties

Updates task properties: title, description, assignedUserId, and flagged status.

Important: This endpoint CANNOT change task status or position. Use PUT /api/v0.2/kanban/task/{id}/move to change status or position.

Behavior:

  • Returns 200 OK with Location header pointing to updated task
  • Follow Location header to GET updated task with new HATEOAS links
  • Requires current version number for optimistic locking

Optimistic Locking: If the task was modified by another user since you last fetched it:

  • You'll receive 409 Conflict
  • Response includes current version number
  • Re-fetch the task with GET to get latest version
  • Retry your update with new version number

Business Rules:

  • Title: 1-500 characters
  • Description: max 10,000 characters
  • Assigned user must exist in your organisation
  • Cannot update soft-deleted tasks
  • Cannot change status or position via this endpoint (returns 400)

Image attachment (optional):

  1. Upload each new image via POST /api/v0.1/image with responsibleService: KANBAN_TASK
  2. Collect the returned imageId values
  3. Include them in the imageIds field of this request Only newly uploaded (unconfirmed) images need to be listed - existing confirmed images are unaffected. Images uploaded but not included here will be removed by the background housekeeping job.
path Parameters
taskId
required
string <uuid>

Task ID

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
assignedUserId
string <uuid>

New assigned user UUID (optional - only if you want to change assignment).

Constraints:

  • User must exist in your organisation

Omit this field if you don't want to change the assignment. Set to null to unassign the task.

description
string [ 0 .. 10000 ] characters

New task description (optional - only if you want to change it).

Constraints:

  • Maximum length: 10,000 characters

Omit this field if you don't want to change the description. Set to empty string to clear the description.

flagged
required
boolean

New flagged status (optional - only if you want to toggle the flag).

Omit this field if you don't want to change the flagged status. Set to true to flag the task as important. Set to false to unflag the task.

imageIds
Array of strings <uuid> [ items <uuid > ]

List of new image IDs to attach to this task (optional).

Two-step upload flow:

  1. Upload each image via POST /api/v0.1/image with responsibleService: KANBAN_TASK
  2. Include the returned imageId values in this list

Images uploaded but not included here will be deleted by the background housekeeping job. Only newly uploaded (unconfirmed) images need to be listed here - existing confirmed images are unaffected.

title
required
string [ 1 .. 500 ] characters

New task title (optional - only if you want to change it).

Constraints:

  • Minimum length: 1 character
  • Maximum length: 500 characters
  • Cannot be blank (only whitespace)

Omit this field if you don't want to change the title.

version
required
integer <int64> >= 1

Current version number for optimistic locking.

How it works:

  • Get this from the task's version field when you last fetched it
  • If another user modified the task since then, you'll receive 409 Conflict
  • Re-fetch the task and retry with new version number

Required: This field is mandatory for all update operations

Example: If the task's current version is 5, provide 5 here. If successful, the task will be updated to version 6.

Responses

Request samples

Content type
application/json
{
  • "assignedUserId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  • "description": "Add OAuth2 with Google, GitHub, and Microsoft providers. Implement MFA support.",
  • "flagged": true,
  • "imageIds": [
    ],
  • "title": "Implement OAuth2 authentication with MFA",
  • "version": 5
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Move task to different status and/or position

Moves a task to a different status column and/or changes its position within a status.

This is the ONLY endpoint that can change task status and position.

Behavior:

  • Returns 200 Ok with Location header pointing to moved task
  • If newPosition is null/omitted -> task moves to end of target status
  • If newPosition is specified -> task inserted at position, others reordered
  • Requires current version number for optimistic locking
  • ALL tasks in the target status are repositioned and receive updated positions

Position Reordering: When you move a task:

  1. The moved task is inserted at the specified position in target status
  2. ALL tasks in the target status are renumbered sequentially (0, 1, 2, 3...)
  3. This ensures positions remain clean and sequential
  4. Important: ALL tasks in the status column receive KanbanBoardTaskMoved events

Example: Given tasks in IN_PROGRESS: [A(0), B(1), C(2), D(3)] Moving A to position 2 results in: [B(0), C(1), A(2), D(3)]

  • Task A moves to position 2
  • Tasks B, C, D are repositioned to 0, 1, 3 respectively
  • 4 events are emitted (one for each task)

Event Broadcasting: This operation emits KanbanBoardTaskMoved domain events for every task whose position changed. Subscribers (WebSocket, SSE, projection handlers) receive updates for all affected tasks.

Status Transitions: All transitions are allowed between any statuses:

  • BACKLOG <--> TO_DO <--> IN_PROGRESS <--> DONE <--> CLOSED
  • Any status -> CANCELLED
  • DONE/CLOSED/CANCELLED -> any status (reopen workflow)

Typical Workflow:

  • Employee completes work: IN_PROGRESS -> DONE
  • Reviewer approves: DONE -> CLOSED
  • Reviewer requests changes: DONE -> IN_PROGRESS

Business Rules:

  • newStatus is required
  • newPosition must be >= 0 if provided (0-based index)
  • newPosition must be <= current number of tasks in target status
  • Cannot move soft-deleted tasks
  • Version number is required for optimistic locking
  • Positions are always 0-based sequential integers
path Parameters
taskId
required
string <uuid>

Task ID

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
newPosition
integer <int32> >= 0

Target position within the status column (0-based).

Behavior:

  • If omitted (null): Task moves to the end of the target status column
  • If specified: Task is inserted at this position, other tasks shift down

Position Reordering: When you specify a position:

  1. Task is inserted at specified position in target status
  2. Tasks at that position and below are shifted down (+1)
  3. Tasks in source status are shifted up to fill the gap
  4. Positions are always 0-based and sequential

Constraints:

  • Must be >= 0
  • Must be <= current number of tasks in target status
  • Position is unique per (organisation, status) for active tasks

Examples:

  • 0: Move to top of status column
  • 2: Insert at position 2 (third item)
  • null: Move to end of status column
newStatus
required
string (TaskStatus)
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED" "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CANCELLED"

Current status of the task in the Kanban workflow.

Available statuses:

  • BACKLOG: Task is planned but not yet ready
  • TO_DO: Task is ready to be picked up
  • IN_PROGRESS: Currently being worked on
  • DONE: Task is completed
  • CANCELLED: Task was cancelled
version
required
integer <int64> >= 1

Current version number for optimistic locking.

How it works:

  • Get this from the task's version field when you last fetched it
  • If another user moved/modified the task since then, you'll receive 409 Conflict
  • Re-fetch the task and retry with new version number

Required: This field is mandatory for all move operations

Example: If the task's current version is 7, provide 7 here. If successful, the task will be updated to version 8.

Responses

Request samples

Content type
application/json
{
  • "newPosition": 2,
  • "newStatus": "IN_PROGRESS",
  • "version": 7
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Refueling

Operations related to refueling

batch

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
incompleteness
boolean
Array of objects (RefuelingRequestBatch)

Responses

Request samples

Content type
application/json
{
  • "incompleteness": true,
  • "refuelings": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

consumption

path Parameters
vehicleId
required
object (VehicleId)
query Parameters
from
required
string <date>
to
required
string <date>
fuel
required
string (Fuel)
Enum: "PETROL" "DIESEL" "AD_BLUE" "COMPRESSED_NATURAL_GAS" "LIQUEFIED_PETROLEUM_GAS" "HYDROGEN" "ELECTRIC"
Example: fuel=PETROL

Fuel type

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getAllRefueling

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createRefueling

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
amount
required
number <double>

Amount of fuel

comment
string

Additional information about refuelling

country
string (Country)
Enum: "AT" "BE" "CZ" "DE" "DK" "ES" "FI" "FR" "HR" "GB" "GR" "HU" "IT" "LT" "NO" "NL" "PL" "PT" "RO" "SE" "SI" "SK" "TR" "UA" "US"
currency
string (Currency)
Enum: "CZK" "EUR" "GBP" "HUF" "PLN" "RON" "UAH" "USD"
distance
required
integer <int32>

Vehicle distance

driverName
string

The name of the driver

fuel
required
string (Fuel)
Enum: "PETROL" "DIESEL" "AD_BLUE" "COMPRESSED_NATURAL_GAS" "LIQUEFIED_PETROLEUM_GAS" "HYDROGEN" "ELECTRIC"

Fuel type

fuelSupplierId
string <uuid>

Fuel supplier

fullRefueling
required
boolean

Mark this refueling as true if the tank was filled to its maximum capacity. This helps improve fuel consumption accuracy and detect anomalies.

invoiceNumber
string

The purchase invoice number

operationDate
required
string <date>

Operation date

operationTime
string

Operation time

stationName
string

The name of the tank station

unitPrice
number

The unit price of the fuel

unitPriceStation
number

The unit price of the fuel at the station

vehicleId
required
object (VehicleId)

Responses

Request samples

Content type
application/json
{
  • "amount": 123,
  • "comment": "Good price",
  • "country": "AT",
  • "currency": "CZK",
  • "distance": 234000,
  • "driverName": "John Smith",
  • "fuel": "PETROL",
  • "fuelSupplierId": "c4290fb9-d99e-4408-8acf-d733761ada33",
  • "fullRefueling": true,
  • "invoiceNumber": "123/2024",
  • "operationDate": "2024-03-12",
  • "operationTime": "12:01:02",
  • "stationName": "Orlen, Krakowska Street",
  • "unitPrice": 1.23,
  • "unitPriceStation": 1.23,
  • "vehicleId": { }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

getRefueling

path Parameters
refuelingId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "amount": 123,
  • "comment": "Good price",
  • "country": "AT",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "currency": "CZK",
  • "distance": 234000,
  • "driverName": "John Smith",
  • "fuel": "PETROL",
  • "fuelSupplierId": "c4290fb9-d99e-4408-8acf-d733761ada33",
  • "fulfillment": true,
  • "fullRefueling": true,
  • "invoiceNumber": "123/2024",
  • "operationDate": "2024-03-12",
  • "operationTime": "12:01:02",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "refuelingId": "472a8ee6-eb9c-4aa4-a142-61abdab47cb3",
  • "stationName": "Orlen, Krakowska Street",
  • "unitPrice": 1.23,
  • "unitPriceStation": 1.23,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

updateRefueling

path Parameters
refuelingId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
amount
required
number <double>

Amount of fuel

comment
string

Additional information about refuelling

country
string (Country)
Enum: "AT" "BE" "CZ" "DE" "DK" "ES" "FI" "FR" "HR" "GB" "GR" "HU" "IT" "LT" "NO" "NL" "PL" "PT" "RO" "SE" "SI" "SK" "TR" "UA" "US"
currency
string (Currency)
Enum: "CZK" "EUR" "GBP" "HUF" "PLN" "RON" "UAH" "USD"
distance
required
integer <int32>

Vehicle distance

driverName
string

The name of the driver

fuel
required
string (Fuel)
Enum: "PETROL" "DIESEL" "AD_BLUE" "COMPRESSED_NATURAL_GAS" "LIQUEFIED_PETROLEUM_GAS" "HYDROGEN" "ELECTRIC"

Fuel type

fuelSupplierId
string <uuid>

Fuel supplier

fullRefueling
required
boolean

Mark this refueling as true if the tank was filled to its maximum capacity. This helps improve fuel consumption accuracy and detect anomalies.

invoiceNumber
string

The purchase invoice number

operationDate
required
string <date>

Operation date

operationTime
string

Operation time

stationName
string

The name of the tank station

unitPrice
number

The unit price of the fuel

unitPriceStation
number

The unit price of the fuel at the station

vehicleId
required
object (VehicleId)

Responses

Request samples

Content type
application/json
{
  • "amount": 123,
  • "comment": "Good price",
  • "country": "AT",
  • "currency": "CZK",
  • "distance": 234000,
  • "driverName": "John Smith",
  • "fuel": "PETROL",
  • "fuelSupplierId": "c4290fb9-d99e-4408-8acf-d733761ada33",
  • "fullRefueling": true,
  • "invoiceNumber": "123/2024",
  • "operationDate": "2024-03-12",
  • "operationTime": "12:01:02",
  • "stationName": "Orlen, Krakowska Street",
  • "unitPrice": 1.23,
  • "unitPriceStation": 1.23,
  • "vehicleId": { }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

report

path Parameters
vehicleId
required
object (VehicleId)
query Parameters
from
required
string <date>
to
required
string <date>
fuel
required
string (Fuel)
Enum: "PETROL" "DIESEL" "AD_BLUE" "COMPRESSED_NATURAL_GAS" "LIQUEFIED_PETROLEUM_GAS" "HYDROGEN" "ELECTRIC"
Example: fuel=PETROL

Fuel type

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "odometers": [
    ],
  • "refuelings": [
    ],
  • "tankLevels": [
    ]
}

Invitation

Organisation invitation management

Get all invitations

Returns all pending invitations for the current organisation. Requires manager privileges.

Responses

Response samples

Content type
application/json

Invitation list

[
  • {
    }
]

Create invitation

Creates a new invitation and sends an email to the invitee. Requires manager privileges.

Request Body schema: application/json
required
createdTimestamp
string <date-time>
email
string
invitationId
string <uuid>
invitedByUser
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createdTimestamp": "2019-08-24T14:15:22Z",
  • "email": "string",
  • "invitationId": "550a4884-8473-4f2e-a6cf-551c16767d59",
  • "invitedByUser": "10957437-f7aa-4d04-927c-ea43f27b0b5d"
}

Response samples

Content type
application/json

Created invitation

{
  • "invitationId": "7e972f0a-62f6-496f-b9b6-3f610c8cb622",
  • "email": "test1@ex.com",
  • "invitedByUser": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "createdTimestamp": "2024-01-15T10:30:00"
}

Delete invitation

Deletes a pending invitation by its ID. Requires manager privileges.

path Parameters
invitationId
required
string <uuid>

Invitation ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get invitation by ID

Returns a specific invitation by its ID. Requires manager privileges.

path Parameters
invitationId
required
string <uuid>

Invitation ID

Responses

Response samples

Content type
application/json

Single invitation

{
  • "invitationId": "7e972f0a-62f6-496f-b9b6-3f610c8cb622",
  • "email": "o1u10@example.com",
  • "invitedByUser": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "createdTimestamp": "2024-01-15T10:30:00"
}

Maintenance

Vehicle maintenance management

updateMaintenanceForVehicleNoImage

path Parameters
maintenanceId
required
string <uuid>
Request Body schema: application/json
required
createDateTime
string <date-time>
distance
integer <int64>
distanceUnit
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"
id
string <uuid>
image
string
Array of objects (MaintenanceItemValueDTO)
operationDate
string <date>
remarks
required
string non-empty
updateDateTime
string <date-time>
updateUserId
string <uuid>
userId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "distance": 0,
  • "distanceUnit": "KILOMETER",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "image": "string",
  • "maintenanceItems": [
    ],
  • "operationDate": "2019-08-24",
  • "remarks": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{ }

findAllMaintenanceForVehicle

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createMaintenanceForVehicle

path Parameters
vehicleId
required
string <uuid>
Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceDTO)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

createMaintenanceForVehicleNoImage

path Parameters
vehicleId
required
string <uuid>
Request Body schema: application/json
required
createDateTime
string <date-time>
distance
integer <int64>
distanceUnit
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"
id
string <uuid>
image
string
Array of objects (MaintenanceItemValueDTO)
operationDate
string <date>
remarks
required
string non-empty
updateDateTime
string <date-time>
updateUserId
string <uuid>
userId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "distance": 0,
  • "distanceUnit": "KILOMETER",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "image": "string",
  • "maintenanceItems": [
    ],
  • "operationDate": "2019-08-24",
  • "remarks": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

deleteMaintenance

path Parameters
maintenanceId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get maintenance by ID

Returns a specific maintenance record by its ID

path Parameters
maintenanceId
required
string <uuid>

Maintenance ID

Responses

Response samples

Content type
application/json

Maintenance response

{
  • "id": "fced9478-dbec-40df-8bc9-9f0382d73da8",
  • "vehicleId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "operationDate": "2019-11-12",
  • "createDateTime": "2021-07-24T18:05:03",
  • "updateDateTime": "2021-07-24T18:05:03",
  • "userId": "e65f2907-9940-4070-9e84-f55d16bfd98e",
  • "updateUserId": "e65f2907-9940-4070-9e84-f55d16bfd98f",
  • "distance": 200,
  • "distanceUnit": "KILOMETER",
  • "remarks": "Brak uwag",
  • "maintenanceItems": [
    ]
}

updateMaintenanceForVehicle

path Parameters
maintenanceId
required
string <uuid>
Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceDTO)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

getImageForMaintenance_2

path Parameters
maintenanceId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Maintenance Item

Vehicle maintenance item management

Get maintenance items for vehicle

Returns a list of maintenance items configured for a specific vehicle

path Parameters
vehicleId
required
string <uuid>

Vehicle ID

Responses

Response samples

Content type
application/json

Maintenance items list

[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Analytics

Analytics and activity tracking endpoints

Get analytics data

Retrieves paginated analytics data with optional filtering.

Features:

  • Pagination support via page and size parameters
  • Entity type filtering via entity parameter
  • Column selection via columns parameter
  • HAL+JSON response with HATEOAS links
  • Bar chart data for visualization

Entity Types:

  • MAINTENANCE: Maintenance activities
  • DUTY: Duty-related activities
  • VEHICLE: Vehicle updates
  • TASK: Task activities
  • LOGIN/LOGOUT: User session activities

Filtering:

  • Use entity=MAINTENANCE to show only maintenance records
  • Use entity=!MAINTENANCE to exclude maintenance records
query Parameters
filter
Array of strings
Example: filter=activity:!CREATED

Filter field. Use ! for exclusion.

columns
Array of strings
Default: "timestamp&columns=entity&columns=activityType&columns=userId"
Example: columns=name,description

Comma-separated list of columns to display.

Available: entity, name, description, status, createdTimestamp, updatedTimestamp

Example: name,description

Leave empty for default column configuration.

sort
string
Default: "+timestamp"
Example: sort=name,description

Comma-separated list of fields to define the sort order.

To indicate sorting direction, fields may be prefixed with + (ascending) or - (descending).

Available: entity, name, description, status, createdTimestamp, updatedTimestamp

Example: /analytics?sort=+entity

Leave empty for default field sort order.

register
required
string (RegisterType)
Enum: "EVENTS" "PROJECTION"
Example: register=EVENTS

Filter by register.

Example: EVENTS

header Parameters
organisation-id
required
string <uuid>
Example: 550e8400-e29b-41d4-a716-446655440000

Organisation ID for which to retrieve analytics

Responses

Response samples

Content type
application/hal+json
{
  • "_links": {
    },
  • "_templates": {
    },
  • "content": {
    },
  • "page": {
    }
}

List calculated fields for the organisation

query Parameters
register
string (RegisterType)
Enum: "EVENTS" "PROJECTION"
header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a calculated field

query Parameters
register
string (RegisterType)
Enum: "EVENTS" "PROJECTION"
header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
description
required
string non-empty

Human-readable label shown in the UI

name
required
string non-empty

Field name used as column identifier

script
required
string non-empty

JavaScript expression evaluated per row

Responses

Request samples

Content type
application/json
{
  • "description": "Cost per km",
  • "name": "costPerKm",
  • "script": "totalCost / distanceValue"
}

Response samples

Content type
application/json
{
  • "calculatedFieldId": "bbe9afeb-41cd-4504-bd3f-bb794ec6f8c5",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "register": "string",
  • "script": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "b0efe45f-0520-4e21-90f0-7e35f137732e"
}

Delete a calculated field

path Parameters
calculatedFieldId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get a single calculated field by ID

path Parameters
calculatedFieldId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "calculatedFieldId": "bbe9afeb-41cd-4504-bd3f-bb794ec6f8c5",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "register": "string",
  • "script": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "b0efe45f-0520-4e21-90f0-7e35f137732e"
}

Update a calculated field

path Parameters
calculatedFieldId
required
string <uuid>
query Parameters
register
string (RegisterType)
Enum: "EVENTS" "PROJECTION"
header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
description
required
string non-empty

Human-readable label shown in the UI

name
required
string non-empty

Field name used as column identifier

script
required
string non-empty

JavaScript expression evaluated per row

Responses

Request samples

Content type
application/json
{
  • "description": "Cost per km",
  • "name": "costPerKm",
  • "script": "totalCost / distanceValue"
}

Response samples

Content type
application/json
{
  • "calculatedFieldId": "bbe9afeb-41cd-4504-bd3f-bb794ec6f8c5",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "register": "string",
  • "script": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "b0efe45f-0520-4e21-90f0-7e35f137732e"
}

User

User management operations

Get current user info

Creates user if not exists and returns user information including account deletion eligibility

Responses

Response samples

Content type
application/json
Example

User is member of a corporate organisation or not owner of private organisation

{
  • "userId": "e65f2907-9940-4070-9e84-f55d16bfd98f",
  • "imageId": null,
  • "canDeleteAccount": false
}

Set or remove current user profile image

Sets the current user's profile image, or removes the existing one.

Only one profile image is supported per user. Calling this endpoint with a new imageId replaces the previous one. Calling with a null imageId removes the current profile image without setting a new one.

Two-step flow (same pattern as kanban task attachments):

  1. Upload the image via POST /api/v0.1/image with responsibleService: USER_PROFILE -> receive imageId
  2. Send this request with the returned imageId to claim ownership

Remove: Send { "imageId": null } to remove the existing profile image without uploading a new one.

Business Rules:

  • When imageId is provided, it must reference an unconfirmed image with responsibleService: USER_PROFILE
  • Any previously confirmed profile image for this user is deleted before the new one is confirmed
Request Body schema: application/json
required
imageId
string or null <uuid>

ID of the previously uploaded image to claim as profile image; null to remove the existing image

Responses

Request samples

Content type
application/json
{
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get user by ID

Returns user information for a specific user within the same organisation

path Parameters
userId
required
string <uuid>

User ID

Responses

Response samples

Content type
application/json
Example

Active user with phone

{
  • "userId": "e65f2907-9940-4070-9e84-f55d16bfd98f",
  • "firstName": "u2",
  • "lastName": "o1",
  • "email": "o1u2@example.com",
  • "phone": "+48123456789"
}

Beacons

Long-lived beacon registrations attached to vehicles or trailers.

List beacons visible to the caller

Returns beacons across all organisations the caller belongs to. Filters narrow the result; values that don't match a membership are silently dropped to avoid leaking existence across tenants.

query Parameters
organisationId
Array of strings <uuid> [ items <uuid > ]
vehicleId
string <uuid>
proximityUuid
string <uuid>
seenSince
string <date-time>
page
integer <int32> >= 0
Default: 0
size
integer <int32> [ 1 .. 200 ]
Default: 50
sort
Array of strings

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Register a new beacon and assign it to a vehicle

Registers a long-lived beacon. The beacon's owning organisation is copied from the assigned vehicle at registration time and remains stable even if the vehicle is later reassigned across organisations.

Multi-tenancy rule: assignedVehicleId must belong to one of the caller's organisations. If not, the server returns 404 rather than 403 to avoid leaking vehicle existence across tenants.

Uniqueness: the tuple (organisationId, proximityUuid, major, minor) is unique. Re-registering the same advertisement triple within the same organisation returns 409 Conflict.

Request Body schema: application/json
required
assignedVehicleId
required
string <uuid>

Vehicle the beacon is physically attached to. Must belong to one of the caller's organisations - otherwise the request returns 404 (the project's pattern is to hide existence on cross-tenant lookups).

label
required
string [ 0 .. 200 ] characters

Human-readable label shown in the mobile UI.

major
required
integer <int32> [ 0 .. 65535 ]

iBeacon major value (0-65535).

minor
required
integer <int32> [ 0 .. 65535 ]

iBeacon minor value (0-65535).

proximityUuid
required
string <uuid>

iBeacon proximity UUID from the advertisement.

txPower
integer or null <int32>

Calibrated RSSI measured at one meter, in dBm. Used by the iOS app to convert RSSI to distance.

vendor
string or null [ 0 .. 100 ] characters

Optional vendor / brand of the beacon hardware.

Responses

Request samples

Content type
application/json
{
  • "assignedVehicleId": "a1b2c3d4-1234-5678-9abc-def012345678",
  • "label": "Trailer TR-505",
  • "major": 1001,
  • "minor": 1,
  • "proximityUuid": "e2c56db5-dffb-48d2-b060-d0f5a71096e0",
  • "txPower": -59,
  • "vendor": "Estimote"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Image

Image upload, retrieval and replacement scoped to an organisation

Upload a new image

Uploads an image and returns a provisional imageId. The image is not yet confirmed and will be removed by a background housekeeping job if it is never claimed.

Two-step confirmation flow:

  1. Call this endpoint to upload the file -> receive imageId
  2. Pass imageId to the relevant domain endpoint (e.g. POST /api/v0.3/organisation) which calls confirmOwnership internally to make the image permanent.

responsibleService declares which domain the image belongs to:

  • ORGANISATION - organisation logo
  • MAINTENANCE - maintenance record attachment
  • TASK - maintenance request attachment
  • KANBAN_TASK - kanban board task attachment
  • DUTY - duty record attachment
  • USER_PROFILE - user profile image
  • VEHICLE - vehicle attachment
header Parameters
required
object (OrganisationId)

Organisation ID

Request Body schema: multipart/form-data
required
file
required
string <binary>

Image file binary

required
object (ImageCreateRequest)

Image metadata

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get image by ID

Returns the raw image bytes. If both width and height are provided the image is resized before being returned.

Responses include a strong ETag derived from the image ID and requested dimensions. Clients should send If-None-Match on subsequent requests to receive a 304 Not Modified without re-downloading the body. Image content is immutable, so the response is safe to cache for up to one year (Cache-Control: private, max-age=31536000, immutable).

path Parameters
imageId
required
string <uuid>

Image ID

query Parameters
width
integer <int32>

Target width in pixels for resizing (requires height)

height
integer <int32>

Target height in pixels for resizing (requires width)

header Parameters
required
object (OrganisationId)

Organisation ID

If-None-Match
string

Conditional GET - supply the ETag received in a previous response

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Replace image file (deprecated) Deprecated

Deprecated. This endpoint will be removed in a future version.

Image replacement is no longer supported. The intended workflow is:

  1. Upload a new image via POST /api/v0.1/image to receive a new imageId.
  2. Pass the new imageId to the domain endpoint (e.g. the kanban task update) which confirms ownership of the new image.
  3. The old image is automatically removed by the background housekeeping job after its retention period expires.
path Parameters
imageId
required
string <uuid>

Image ID

header Parameters
required
object (OrganisationId)

Organisation ID

Request Body schema: multipart/form-data
required
file
required
string <binary>

Replacement image file binary

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Grow Report

Fleet mileage growth reports

Get fleet mileage growth report

Returns monthly mileage data grouped by month with year columns showing total mileage for the organisation's fleet

header Parameters
organisation-id
required
string <uuid>

Organisation ID

Responses

Response samples

Content type
application/json

Monthly mileage report

[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Kanban - Queries

Task query operations

List tasks with filtering and pagination Deprecated

Retrieves a paginated list of tasks for your organisation in HAL+JSON format.

Response Format (HAL+JSON):

  • _embedded.tasks: Array of task objects
  • _links: Hypermedia links (self, next, prev, last, create)
  • page: Pagination metadata

Each task includes:

  • Current task data (no event history for performance)
  • _links object with available actions based on task state

HATEOAS Links: Each task includes state-driven links showing available actions:

  • self: Link to task details with full event history
  • update: Link to update task properties
  • move: Link to move task to different status
  • delete: Link to soft delete task (includes version)
  • flag/unflag: Toggle flag based on current state
  • reopen: For DONE/CLOSED/CANCELLED tasks

Filtering: Combine multiple filters to narrow results:

  • By status: ?status=IN_PROGRESS
  • By assigned user: ?assignedUserId=uuid
  • Show flagged only: ?flagged=true
  • Show deleted tasks: ?deleted=true

Pagination:

  • Default page size: 20
  • Use page parameter for page number (0-based)
  • Use size parameter for page size (max: 100)
  • Use sort for ordering (e.g., position,asc or createdAt,desc)

Position Ordering:

  • Positions are 0-based sequential integers within each status (0, 1, 2, 3...)
  • When tasks are moved, ALL tasks in the target status are renumbered sequentially
  • Sort by position,asc to get tasks in display order for Kanban columns
  • Positions may have gaps after deletions (gaps are filled on next move operation)

Performance: This endpoint is optimized for list views and does NOT include event history. To get full event history, use GET /api/v0.1/kanban/task/{id}.

Use Cases:

  • Display Kanban board: ?status=IN_PROGRESS&sort=position,asc
  • Show user's tasks: ?assignedUserId={userId}
  • List flagged tasks: ?flagged=true
  • Recent tasks: ?sort=createdAt,desc&size=10
  • Deleted tasks: ?deleted=true (for admin/recovery)
query Parameters
status
string
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED"

Filter by task status

assignedUserId
string <uuid>

Filter by assigned user UUID

flagged
boolean

Filter by flagged status

required
object (Pageable)
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json
{
  • "_embedded": {
    },
  • "_links": {
    },
  • "page": {
    }
}

Get metadata for creating a new task Deprecated

Retrieves metadata needed to create a new task in HAL+JSON format.

Response includes:

  • Available task statuses with descriptions
  • HATEOAS links to related resources

HATEOAS Links:

  • self: Link to this metadata endpoint
  • create: Link to create new task (POST /api/v0.1/kanban/task)
  • members: Link to get organization members for assignment (GET /api/v0.2/member/)

Use Cases:

  • Display task creation form with status dropdown
  • Get list of assignable users for the task
  • Discover available actions for task creation workflow

Client Workflow:

  1. Call this endpoint to get metadata
  2. Follow members link to fetch assignable users
  3. User fills in task details (title, description, assignee, status)
  4. Follow create link to POST new task

Status Options: Each status includes:

  • value: Enum value (e.g., "BACKLOG", "TO_DO")
  • description: Human-readable explanation
  • isDefault: Whether this is the default status (BACKLOG = true)
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json
{
  • "availableStatuses": [
    ],
  • "_links": {
    }
}

Get task by ID with complete event history Deprecated

Retrieves a single task with its complete event history in HAL+JSON format.

Response includes:

  • Current task state with all fields
  • _links: HATEOAS links for all available actions
  • _embedded.events: Complete event history (audit log)

Event History: Shows every change made to the task since creation. Event types are sealed:

  • KanbanBoardTaskCreated: Initial task creation
    • Includes: version, timestamp, userId, title, description, assignedUserId, status, taskNumber, flagged, position
  • KanbanBoardTaskUpdated: Field changes (title, description, assignedUserId, flagged)
    • Includes: version, timestamp, userId, title, description, assignedUserId, status, taskNumber, flagged
  • KanbanBoardTaskMoved: Status/position changes
    • Includes: timestamp, userId, status, position (no version field)
    • Note: Multiple move events may appear when other tasks are repositioned
  • KanbanBoardTaskDeleted: Soft deletion
    • Includes: version, timestamp, userId

Event Fields:

  • All events include: organisationId, contextId, timestamp, userId
  • Most events include: version number (for optimistic locking)
  • Move events do NOT include version (lightweight position updates)
  • Each event contains specific payload data relevant to that operation

HATEOAS Links: The _links object shows ALL available actions based on current state:

  • Standard actions: self, collection, update, move, delete
  • State-specific: move-to-backlog, move-to-todo, move-to-closed, etc.
  • Contextual: flag/unflag, reopen (for DONE/CLOSED/CANCELLED)
  • Resources: members (GET /api/v0.2/member/ - for getting assignable users)
  • Comments: comments (GET comments), add-comment (POST new comment)

Query Parameters:

  • includeHistory: Set to false to exclude event history (default: true)
  • historySortOrder: Sort events by timestamp (asc or desc, default: desc)

Use Cases:

  • View task details: Default behavior
  • Audit trail: Review event history to see all changes
  • Compliance: Export complete task lifecycle
  • Debugging: Understand how task reached current state
  • Excluding history: ?includeHistory=false for faster response

Performance Note: Including event history requires joining with event store. For list views, use GET /api/v0.1/kanban/task instead (no history).

path Parameters
taskId
required
string <uuid>

Task ID

query Parameters
includeHistory
boolean
Default: true

Include event history (default: true)

header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json

Task Detail with Comments Links

{
  • "contextId": "123e4567-e89b-12d3-a456-426614174000",
  • "title": "Implement dark mode",
  • "description": "Add dark mode toggle to application settings",
  • "assignedUserId": "987fcdeb-51a2-43f1-9876-fedcba987654",
  • "status": "IN_PROGRESS",
  • "position": 2,
  • "taskNumber": 42,
  • "flagged": true,
  • "version": 3,
  • "createdAt": "2025-01-15T10:30:00Z",
  • "updatedAt": "2025-01-16T14:20:00Z",
  • "_links": {
    },
  • "_embedded": {
    }
}

List tasks with filtering and pagination

Retrieves a paginated list of tasks for your organisation in HAL+JSON format.

Response Format (HAL+JSON):

  • _embedded.tasks: Array of task objects
  • _links: Hypermedia links (self, next, prev, last, create)
  • page: Pagination metadata

Each task includes:

  • Current task data (no event history for performance)
  • _links object with available actions based on task state

HATEOAS Links: Each task includes state-driven links showing available actions:

  • self: Link to task details with full event history
  • update: Link to update task properties
  • move: Link to move task to different status
  • delete: Link to soft delete task (includes version)
  • flag/unflag: Toggle flag based on current state
  • reopen: For DONE/CLOSED/CANCELLED tasks

Filtering: Combine multiple filters to narrow results:

  • By status: ?status=IN_PROGRESS
  • By assigned user: ?assignedUserId=uuid
  • Show flagged only: ?flagged=true
  • Show deleted tasks: ?deleted=true

Pagination:

  • Default page size: 20
  • Use page parameter for page number (0-based)
  • Use size parameter for page size (max: 100)
  • Use sort for ordering (e.g., position,asc or createdAt,desc)

Position Ordering:

  • Positions are 0-based sequential integers within each status (0, 1, 2, 3...)
  • When tasks are moved, ALL tasks in the target status are renumbered sequentially
  • Sort by position,asc to get tasks in display order for Kanban columns
  • Positions may have gaps after deletions (gaps are filled on next move operation)

Performance: This endpoint is optimized for list views and does NOT include event history. To get full event history, use GET /api/v0.2/kanban/task/{id}.

Use Cases:

  • Display Kanban board: ?status=IN_PROGRESS&sort=position,asc
  • Show user's tasks: ?assignedUserId={userId}
  • List flagged tasks: ?flagged=true
  • Recent tasks: ?sort=createdAt,desc&size=10
  • Deleted tasks: ?deleted=true (for admin/recovery)
query Parameters
status
string
Enum: "BACKLOG" "TO_DO" "IN_PROGRESS" "DONE" "CLOSED" "CANCELLED"

Filter by task status

assignedUserId
string <uuid>

Filter by assigned user UUID

flagged
boolean

Filter by flagged status

required
object (Pageable)
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json
{
  • "_embedded": {
    },
  • "_links": {
    },
  • "page": {
    }
}

Get metadata for creating a new task

Retrieves metadata needed to create a new task in HAL+JSON format.

Response includes:

  • Available task statuses with descriptions
  • HATEOAS links to related resources

HATEOAS Links:

  • self: Link to this metadata endpoint
  • create: Link to create new task (POST /api/v0.2/kanban/task)
  • members: Link to get organization members for assignment (GET /api/v0.2/member/)

Use Cases:

  • Display task creation form with status dropdown
  • Get list of assignable users for the task
  • Discover available actions for task creation workflow

Client Workflow:

  1. Call this endpoint to get metadata
  2. Follow members link to fetch assignable users
  3. User fills in task details (title, description, assignee, status)
  4. Follow create link to POST new task

Status Options: Each status includes:

  • value: Enum value (e.g., "BACKLOG", "TO_DO")
  • description: Human-readable explanation
  • isDefault: Whether this is the default status (BACKLOG = true)
header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json
{
  • "availableStatuses": [
    ],
  • "_links": {
    }
}

Get task by ID with complete event history

Retrieves a single task with its complete event history in HAL+JSON format.

Response includes:

  • Current task state with all fields
  • imageIds: List of confirmed image IDs - fetch each via GET /api/v0.2/image/{imageId}
  • _links: HATEOAS links for all available actions
  • _embedded.events: Complete event history (audit log)

Event History: Shows every change made to the task since creation. Event types are sealed:

  • KanbanBoardTaskCreated: Initial task creation
    • Includes: version, timestamp, userId, title, description, assignedUserId, status, taskNumber, flagged, position
  • KanbanBoardTaskUpdated: Field changes (title, description, assignedUserId, flagged)
    • Includes: version, timestamp, userId, title, description, assignedUserId, status, taskNumber, flagged
  • KanbanBoardTaskMoved: Status/position changes
    • Includes: timestamp, userId, status, position (no version field)
    • Note: Multiple move events may appear when other tasks are repositioned
  • KanbanBoardTaskDeleted: Soft deletion
    • Includes: version, timestamp, userId

Event Fields:

  • All events include: organisationId, contextId, timestamp, userId
  • Most events include: version number (for optimistic locking)
  • Move events do NOT include version (lightweight position updates)
  • Each event contains specific payload data relevant to that operation

HATEOAS Links: The _links object shows ALL available actions based on current state:

  • Standard actions: self, collection, update, move, delete
  • State-specific: move-to-backlog, move-to-todo, move-to-closed, etc.
  • Contextual: flag/unflag, reopen (for DONE/CLOSED/CANCELLED)
  • Resources: members (GET /api/v0.2/member/ - for getting assignable users)
  • Comments: comments (GET comments), add-comment (POST new comment)

Query Parameters:

  • includeHistory: Set to false to exclude event history (default: true)
  • historySortOrder: Sort events by timestamp (asc or desc, default: desc)

Use Cases:

  • View task details: Default behavior
  • Audit trail: Review event history to see all changes
  • Compliance: Export complete task lifecycle
  • Debugging: Understand how task reached current state
  • Excluding history: ?includeHistory=false for faster response

Performance Note: Including event history requires joining with event store. For list views, use GET /api/v0.2/kanban/task instead (no history).

path Parameters
taskId
required
string <uuid>

Task ID

query Parameters
includeHistory
boolean
Default: true

Include event history (default: true)

header Parameters
organisation-id
required
string <uuid>

Organisation UUID from header

Responses

Response samples

Content type
application/hal+json

Task Detail with Comments Links

{
  • "contextId": "123e4567-e89b-12d3-a456-426614174000",
  • "title": "Implement dark mode",
  • "description": "Add dark mode toggle to application settings",
  • "assignedUserId": "987fcdeb-51a2-43f1-9876-fedcba987654",
  • "status": "IN_PROGRESS",
  • "position": 2,
  • "taskNumber": 42,
  • "flagged": true,
  • "version": 3,
  • "imageIds": [
    ],
  • "createdAt": "2025-01-15T10:30:00Z",
  • "updatedAt": "2025-01-16T14:20:00Z",
  • "_links": {
    },
  • "_embedded": {
    }
}

API

API root endpoints for application discovery

Get API root links

Returns HATEOAS links for the specified application.

Available applications:

  • FLEET: Fleet management application links

Response includes navigation links to:

  • activity: User activity list
  • analytics: Analytics dashboard
query Parameters
app
required
string
Example: app=FLEET

Application identifier

Responses

Response samples

Content type
application/hal+json
{
  • "_links": {
    }
}

Member

Organisation member management

Get all organisation members

Returns all members of the specified organisation sorted by last name and first name

header Parameters
organisation-id
required
string <uuid>

Organisation ID

Responses

Response samples

Content type
application/json
Example

Deleted member

[
  • {
    }
]

Create member

Creates a new Member directly from office-provided details (e.g. a driver profile), without going through the User Invitation flow. Provisions a disabled, credential-less KeyCloak account upfront; App Access can be granted later via Activation. Requires manager privileges.

header Parameters
organisation-id
required
string <uuid>

Organisation ID

Request Body schema: application/json
required
email
required
string <email> non-empty
firstName
required
string non-empty
lastName
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "firstName": "string",
  • "lastName": "string"
}

Response samples

Content type
application/json

Created member

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "Jane",
  • "lastName": "Doe",
  • "enabled": true,
  • "isManager": false,
  • "appAccessEnabled": false,
  • "appAccessNote": null
}

Update member

Updates a member's enabled status and manager privileges. Requires manager privileges; a manager cannot update their own membership.

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
appAccessEnabled
boolean
appAccessNote
string
enabled
boolean
firstName
string
isManager
boolean
lastName
string
userId
required
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "appAccessEnabled": true,
  • "appAccessNote": "string",
  • "enabled": true,
  • "firstName": "string",
  • "isManager": true,
  • "lastName": "string",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b"
}

Response samples

Content type
application/json

Updated member

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "u1",
  • "lastName": "o1",
  • "enabled": true,
  • "isManager": true,
  • "appAccessEnabled": true,
  • "appAccessNote": null
}

Get current user's membership

Returns the current user's membership details and privileges in the specified organisation

header Parameters
organisation-id
required
string <uuid>

Organisation ID

Responses

Response samples

Content type
application/json
Example

Member with active account

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "John",
  • "lastName": "Smith",
  • "enabled": true,
  • "isManager": false,
  • "appAccessEnabled": true,
  • "appAccessNote": null
}

Get member by ID

Returns a specific member by their user ID. Requires manager privileges.

path Parameters
userId
required
string <uuid>

User ID of the member

header Parameters
organisation-id
required
string <uuid>

Organisation ID

Responses

Response samples

Content type
application/json
Example

Active member

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "u1",
  • "lastName": "o1",
  • "enabled": true,
  • "isManager": true,
  • "appAccessEnabled": true,
  • "appAccessNote": null
}

Activate App Access

Grants App Access to a Member: enables their KeyCloak account and sends them an email to set their own password (Activation). The Member completes the setup themselves. Requires manager privileges; a manager cannot activate their own App Access. Independent of Member Enabled status.

path Parameters
userId
required
string <uuid>

User ID of the member

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
note
string

Responses

Request samples

Content type
application/json
{
  • "note": "string"
}

Response samples

Content type
application/json

Activated member

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "Jane",
  • "lastName": "Doe",
  • "enabled": true,
  • "isManager": false,
  • "appAccessEnabled": true,
  • "appAccessNote": "Requested by office on 2024-01-15"
}

Deactivate App Access

Revokes App Access from a Member by disabling their KeyCloak account; no email is sent. Requires manager privileges; a manager cannot deactivate their own App Access. Independent of Member Enabled status.

path Parameters
userId
required
string <uuid>

User ID of the member

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
note
string

Responses

Request samples

Content type
application/json
{
  • "note": "string"
}

Response samples

Content type
application/json

Deactivated member

{
  • "userId": "a25f2907-9940-4070-9e84-f55d16bfd98a",
  • "firstName": "Jane",
  • "lastName": "Doe",
  • "enabled": true,
  • "isManager": false,
  • "appAccessEnabled": false,
  • "appAccessNote": "No longer needs app access - office handles handovers"
}

Comments - Query

Query comments on any resource

List comments for a resource

Retrieves paginated list of comments for any resource (task, vehicle, etc.).

Returns active (non-deleted) comments by default, sorted chronologically. Supports pagination via page, size, and sort parameters.

Response includes HATEOAS links for navigation (self, first, next, prev, last). Each comment includes state-driven action links (edit, delete) based on authorization.

Authorizations:
None
path Parameters
contextType
required
string (ContextType)
Enum: "task" "vehicle" "maintenance-order" "fuel-record" "task" "vehicle" "maintenance-order" "fuel-record"
Example: task

Type of parent resource

required
object (ContextId)
Example: 660e8400-e29b-41d4-a716-446655440000

Parent resource identifier

query Parameters
includeDeleted
boolean
Default: false

Include soft-deleted comments

required
object (Pageable)

Pagination parameters (page, size, sort)

header Parameters
required
object (OrganisationId)

Organisation identifier

Responses

Response samples

Content type
application/hal+json
{
  • "_embedded": {
    },
  • "_links": {
    },
  • "page": {
    }
}

Vehicle

Vehicle details

Get all vehicles for organisation

Returns a list of all vehicles belonging to the specified organisation, filtered by enabled status

path Parameters
organisationId
required
string <uuid>

Organisation ID

query Parameters
enabled
boolean
Default: true
Example: enabled=true

Filter by enabled status

Responses

Response samples

Content type
application/json

Vehicle list

[
  • {
    }
]

Create vehicle

Creates a new vehicle in the organisation.

Image attachment (optional):

  1. Upload each image via POST /api/v0.1/image with responsibleService: VEHICLE
  2. Collect the returned imageId values
  3. Include them in the imageIds field of this request Images not confirmed via imageIds will be removed by the background housekeeping job.
path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
color
string (VehicleColor)
Enum: "BLACK" "WHITE" "GRAY" "RED" "BLUE" "GREEN" "DARK_BLUE" "SILVER"
destinationId
required
string <uuid>
enabled
boolean
firstRegistrationInCountryDate
string <date>
imageIds
Array of strings <uuid> [ items <uuid > ]
modelId
required
string <uuid>
productionDate
string <date>
registration
required
string non-empty
registrationDate
string <date>
remarks
required
string
trailerMillage
required
boolean
vin
string

Responses

Request samples

Content type
application/json
{
  • "color": "BLACK",
  • "destinationId": "d0a0ebc7-d6b4-4f3c-a5af-5761a8148e3a",
  • "enabled": true,
  • "firstRegistrationInCountryDate": "2019-08-24",
  • "imageIds": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "productionDate": "2019-08-24",
  • "registration": "string",
  • "registrationDate": "2019-08-24",
  • "remarks": "string",
  • "trailerMillage": true,
  • "vin": "string"
}

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "axesCount": 0,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "brandName": "string",
  • "color": "BLACK",
  • "createdPersonId": "725aa23d-feb7-48a8-9f3f-3bed04243ae5",
  • "createdTimestamp": "2019-08-24T14:15:22Z",
  • "destinationId": "d0a0ebc7-d6b4-4f3c-a5af-5761a8148e3a",
  • "distanceUnit": "KILOMETER",
  • "dutyStatus": "ERROR",
  • "enabled": true,
  • "firstRegistrationInCountryDate": "2019-08-24",
  • "imageIds": [
    ],
  • "maintenanceStatus": "ERROR",
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "modelName": "string",
  • "productionDate": "2019-08-24",
  • "registration": "string",
  • "registrationDate": "2019-08-24",
  • "remarks": "string",
  • "taskStatus": "ERROR",
  • "trailer": true,
  • "trailerMillage": true,
  • "updatedPersonId": "94de6710-6ec2-42e9-b486-8ddb836e206e",
  • "updatedTimestamp": "2019-08-24T14:15:22Z",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vin": "string"
}

Get vehicle by ID

Returns a specific vehicle by its ID within the organisation

path Parameters
organisationId
required
string <uuid>

Organisation ID

vehicleId
required
string <uuid>

Vehicle ID

Responses

Response samples

Content type
application/json

Vehicle response

{
  • "vehicleId": "9026e67c-309f-409d-affc-0b78f0b0db92",
  • "axesCount": 2,
  • "vin": null,
  • "registration": "RZ09876",
  • "brandId": "b35f2907-9940-4070-9e84-f55d16bfd98b",
  • "brandName": "BMW",
  • "modelId": "60ca8601-5639-43cd-a1ba-dd7e248112c3",
  • "modelName": "320i",
  • "registrationDate": "2015-01-01",
  • "firstRegistrationInCountryDate": null,
  • "productionDate": null,
  • "color": null,
  • "distanceUnit": "MILE",
  • "remarks": "Drive carefully",
  • "enabled": true,
  • "destinationId": "2d68b5d6-3494-49ca-84e8-6dfe34f148a9",
  • "trailer": false,
  • "trailerMillage": false,
  • "dutyStatus": null,
  • "maintenanceStatus": null,
  • "taskStatus": null,
  • "createdTimestamp": "2020-01-02T10:11:12",
  • "updatedTimestamp": "2020-02-03T11:12:13",
  • "createdPersonId": "e65f2907-9940-4070-9e84-f55d16bfd98e",
  • "updatedPersonId": "e65f2907-9940-4070-9e84-f55d16bfd98e"
}

Update vehicle

Updates an existing vehicle.

Image attachment (optional):

  1. Upload each new image via POST /api/v0.1/image with responsibleService: VEHICLE
  2. Collect the returned imageId values
  3. Include them in the imageIds field of this request Only newly uploaded (unconfirmed) images need to be listed - existing confirmed images are unaffected. Images uploaded but not included here will be removed by the background housekeeping job.
path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>
Request Body schema: application/json
required
color
string (VehicleColor)
Enum: "BLACK" "WHITE" "GRAY" "RED" "BLUE" "GREEN" "DARK_BLUE" "SILVER"
destinationId
required
string <uuid>
enabled
boolean
firstRegistrationInCountryDate
string <date>
imageIds
Array of strings <uuid> [ items <uuid > ]
modelId
required
string <uuid>
productionDate
string <date>
registration
required
string non-empty
registrationDate
string <date>
remarks
required
string
trailerMillage
required
boolean
vin
string

Responses

Request samples

Content type
application/json
{
  • "color": "BLACK",
  • "destinationId": "d0a0ebc7-d6b4-4f3c-a5af-5761a8148e3a",
  • "enabled": true,
  • "firstRegistrationInCountryDate": "2019-08-24",
  • "imageIds": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "productionDate": "2019-08-24",
  • "registration": "string",
  • "registrationDate": "2019-08-24",
  • "remarks": "string",
  • "trailerMillage": true,
  • "vin": "string"
}

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "axesCount": 0,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "brandName": "string",
  • "color": "BLACK",
  • "createdPersonId": "725aa23d-feb7-48a8-9f3f-3bed04243ae5",
  • "createdTimestamp": "2019-08-24T14:15:22Z",
  • "destinationId": "d0a0ebc7-d6b4-4f3c-a5af-5761a8148e3a",
  • "distanceUnit": "KILOMETER",
  • "dutyStatus": "ERROR",
  • "enabled": true,
  • "firstRegistrationInCountryDate": "2019-08-24",
  • "imageIds": [
    ],
  • "maintenanceStatus": "ERROR",
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "modelName": "string",
  • "productionDate": "2019-08-24",
  • "registration": "string",
  • "registrationDate": "2019-08-24",
  • "remarks": "string",
  • "taskStatus": "ERROR",
  • "trailer": true,
  • "trailerMillage": true,
  • "updatedPersonId": "94de6710-6ec2-42e9-b486-8ddb836e206e",
  • "updatedTimestamp": "2019-08-24T14:15:22Z",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vin": "string"
}

Beacon observations

Append-only ingestion of raw beacon sightings from the mobile app.

Ingest a batch of beacon observations

Stores a batch of raw beacon sightings. No business rules (coupling detection, trailer attach/detach) are evaluated in this call - those run downstream from the raw event log.

Identity: observerUserId is taken from the authenticated principal, not from the request body.

Beacon resolution: each item is resolved by (proximityUuid, major, minor) against all beacons visible to the caller. Outcomes:

  • exactly one match -> observation persisted, firstSeenAt (if null) and lastSeenAt updated on the beacon
  • no match -> item index reported in unknownBeaconIndices
  • more than one match across the caller's organisations -> item index reported in ambiguousBeaconIndices

Timestamp window: items with observedAt more than 24 h in the past or more than 5 min in the future are rejected and reported in invalidTimestampIndices.

Transaction: all accepted observations are inserted in a single transaction; rejected items have no side effect.

Batch limit: 500 observations per request. Larger batches return 413 Payload Too Large.

Request Body schema: application/json
required
required
Array of objects (ObservationItem) [ 1 .. 500 ] characters [ 0 .. 500 ] items [ items [ 1 .. 500 ] characters ]

Beacon sightings in chronological order. Each item is resolved independently against the caller's beacons.

required
object (ObserverDescriptor)

Self-description of the device sending the batch. observerUserId is never taken from the request body - the server uses the authenticated principal.

Responses

Request samples

Content type
application/json

Two-beacon sighting from a moving truck

{
  • "observer": {
    },
  • "observations": [
    ]
}

Response samples

Content type
*/*
{
  "acceptedCount": 18,
  "unknownBeaconIndices": [
    3,
    7
  ],
  "ambiguousBeaconIndices": [],
  "invalidTimestampIndices": []
}

Dashboard

Dashboard statistics and metrics

Get dashboard statistics

Returns dashboard statistics including total average speed across all enabled vehicles in the organisation

Responses

Response samples

Content type
application/json
Example

Empty fleet

{
  • "totalSpeed": 0
}

Fuel Supplier

Operations related to fuel supplier

getAllFuelSupplier

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createFuelSupplier

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
comment
string

Additional unstructured comment

name
required
string non-empty

Name of the fuel supplier

Responses

Request samples

Content type
application/json
{
  • "comment": "Contact person John Doe I",
  • "name": "Global Track Warehouse"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

getFuelSupplier

path Parameters
fuelSupplierId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "fuelSupplierId": "4b36bd9b-7b78-491a-989d-af9809b3d3c0",
  • "name": "Global Track Warehouse",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

updateFuelSupplier

path Parameters
fuelSupplierId
required
string <uuid>
header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
comment
string

Additional unstructured comment

name
required
string non-empty

Name of the fuel supplier

Responses

Request samples

Content type
application/json
{
  • "comment": "Contact person John Doe I",
  • "name": "Global Track Warehouse"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Maintenance Requests V0.4

API for managing vehicle maintenance requests with HATEOAS support

Get all maintenance requests for organization

Retrieves all active (not done) maintenance requests for the user's organization with HATEOAS links

Responses

Response samples

Content type
application/json
{
  • "_embedded": {
    },
  • "_links": {
    }
}

Get all maintenance requests for a vehicle

Retrieves all maintenance requests for a specific vehicle with HATEOAS links

path Parameters
vehicleId
required
string <uuid>

Vehicle ID

Responses

Response samples

Content type
application/json
{
  • "_embedded": {
    },
  • "_links": {
    }
}

Create maintenance request

Creates a new maintenance request for a vehicle with optional image attachment

path Parameters
vehicleId
required
string <uuid>

Vehicle ID

Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceRequestDTOV04)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Get maintenance request by ID

Retrieves a specific maintenance request with HATEOAS links

path Parameters
maintenanceRequestId
required
string <uuid>

Maintenance request ID

Responses

Response samples

Content type
application/json
{
  • "atKilometers": 0,
  • "createDate": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "cyclical": true,
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "editDate": "2019-08-24T14:15:22Z",
  • "editUserId": "b8cb20cd-fd09-4975-ad6b-1f7347c2e8ed",
  • "everyDays": 0,
  • "expirationDate": "2019-08-24",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "inspRequest": "string",
  • "status": "UNSET",
  • "vehicleBrand": "string",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vehicleModel": "string",
  • "vehicleRegistration": "string"
}

Update maintenance request

Updates an existing maintenance request with optional image replacement

path Parameters
maintenanceRequestId
required
string <uuid>

Maintenance request ID

Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceRequestDTOV04)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

Mark maintenance request as done or undone

Marks a maintenance request as done or undone. If marking as done for a cyclical request, creates a new request for the next cycle.

path Parameters
maintenanceRequestId
required
string <uuid>

Maintenance request ID

Request Body schema: application/json
required
done
required
boolean
doneDate
string <date-time>
doneUserId
string <uuid>
id
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Response samples

Content type
application/json
{
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Get maintenance request image

Retrieves the image attached to a maintenance request

path Parameters
maintenanceRequestId
required
string <uuid>

Maintenance request ID

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

asset-controller

getAll_8

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_8

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
assetId
string <uuid>
createDateTime
string <date-time>
createUserId
string <uuid>
description
string
name
string
object (OrganisationId)
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

update_9

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
assetId
string <uuid>
createDateTime
string <date-time>
createUserId
string <uuid>
description
string
name
string
object (OrganisationId)
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

get_8

path Parameters
assetId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "name": "string",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

asset-instance-controller

getAll_9

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_9

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
amount
integer <int32>
assetId
string <uuid>
assetInstanceId
string <uuid>
createDateTime
string <date-time>
createUserId
string <uuid>
deleted
boolean
deletedDateTime
string <date-time>
deletedUserId
string <uuid>
object (OrganisationId)
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

update_10

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
amount
integer <int32>
assetId
string <uuid>
assetInstanceId
string <uuid>
createDateTime
string <date-time>
createUserId
string <uuid>
deleted
boolean
deletedDateTime
string <date-time>
deletedUserId
string <uuid>
object (OrganisationId)
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

delete_1

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
amount
integer <int32>
assetId
string <uuid>
assetInstanceId
string <uuid>
createDateTime
string <date-time>
createUserId
string <uuid>
deleted
boolean
deletedDateTime
string <date-time>
deletedUserId
string <uuid>
object (OrganisationId)
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

get_9

path Parameters
assetInstanceId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "amount": 0,
  • "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
  • "assetInstanceId": "605efab6-99a7-4ea3-8f61-391429fbad2b",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "deleted": true,
  • "deletedDateTime": "2019-08-24T14:15:22Z",
  • "deletedUserId": "c86f3097-82ed-4a8c-80e7-9b6637ef5759",
  • "organisationId": {
    },
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

audit-controller

getAll_11

Responses

Response samples

Content type
application/json
[
  • {
    }
]

checklist-controller

getAll_7

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_7

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
checklistId
string <uuid>
closed
boolean
closedDate
string <date-time>
closedUserId
string <uuid>
comment
string
createDateTime
string <date-time>
createUserId
string <uuid>
description
string
Array of objects (ChecklistItemDTO)
name
string
operationDate
string <date>
organisationId
string <uuid>
template
boolean
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

update_8

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
checklistId
string <uuid>
closed
boolean
closedDate
string <date-time>
closedUserId
string <uuid>
comment
string
createDateTime
string <date-time>
createUserId
string <uuid>
description
string
Array of objects (ChecklistItemDTO)
name
string
operationDate
string <date>
organisationId
string <uuid>
template
boolean
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

get_7

path Parameters
checklistId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

close

path Parameters
checklistId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "checklistId": "9c2471f0-7b0e-4603-bb5c-ee5fa92d766a",
  • "closed": true,
  • "closedDate": "2019-08-24T14:15:22Z",
  • "closedUserId": "f33cf7f8-af45-40d7-bf15-cfa1fa469453",
  • "comment": "string",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "operationDate": "2019-08-24",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "template": true,
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

coupling-controller

getCouplings

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createCoupling

Request Body schema: application/json
required
carBrand
string
carId
required
string <uuid>
carModel
string
carRegistration
string
coupledDate
string <date>
coupledDistance
required
integer <int64>
coupledPersonId
string <uuid>
coupledRemarks
string
coupledTrailerDistance
integer <int64>
createDateTime
string <date-time>
decoupledDate
string <date>
decoupledDateTime
string <date-time>
decoupledDistance
integer <int64>
decoupledPersonId
string <uuid>
decoupledRemarks
string
decoupledTrailerDistance
integer <int64>
id
string <uuid>
trailerBrand
string
trailerId
required
string <uuid>
trailerModel
string
trailerRegistration
string
updateDateTime
string <date-time>
updatePersonId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "carBrand": "string",
  • "carId": "566dcc5d-30ab-488e-96e1-c09dec523f18",
  • "carModel": "string",
  • "carRegistration": "string",
  • "coupledDate": "2019-08-24",
  • "coupledDistance": 0,
  • "coupledPersonId": "6c41767c-738c-45d1-85ff-44593d0abedf",
  • "coupledRemarks": "string",
  • "coupledTrailerDistance": 0,
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDate": "2019-08-24",
  • "decoupledDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDistance": 0,
  • "decoupledPersonId": "e8698e97-a658-468a-8bc7-6a9cf8a6f1ac",
  • "decoupledRemarks": "string",
  • "decoupledTrailerDistance": 0,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "trailerBrand": "string",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "trailerModel": "string",
  • "trailerRegistration": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updatePersonId": "069b7006-3570-4408-a633-a325fbeb33e1"
}

Response samples

Content type
application/json
{ }

getCouplings_1

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getCoupleableTrailers

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getCouplingForVehicle

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "coupleable": true,
  • "couplings": [
    ]
}

getCoupling

path Parameters
couplingId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "carBrand": "string",
  • "carId": "566dcc5d-30ab-488e-96e1-c09dec523f18",
  • "carModel": "string",
  • "carRegistration": "string",
  • "coupledDate": "2019-08-24",
  • "coupledDistance": 0,
  • "coupledPersonId": "6c41767c-738c-45d1-85ff-44593d0abedf",
  • "coupledRemarks": "string",
  • "coupledTrailerDistance": 0,
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDate": "2019-08-24",
  • "decoupledDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDistance": 0,
  • "decoupledPersonId": "e8698e97-a658-468a-8bc7-6a9cf8a6f1ac",
  • "decoupledRemarks": "string",
  • "decoupledTrailerDistance": 0,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "trailerBrand": "string",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "trailerModel": "string",
  • "trailerRegistration": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updatePersonId": "069b7006-3570-4408-a633-a325fbeb33e1"
}

updateCoupling

path Parameters
couplingId
required
string <uuid>
Request Body schema: application/json
required
carBrand
string
carId
required
string <uuid>
carModel
string
carRegistration
string
coupledDate
string <date>
coupledDistance
required
integer <int64>
coupledPersonId
string <uuid>
coupledRemarks
string
coupledTrailerDistance
integer <int64>
createDateTime
string <date-time>
decoupledDate
string <date>
decoupledDateTime
string <date-time>
decoupledDistance
integer <int64>
decoupledPersonId
string <uuid>
decoupledRemarks
string
decoupledTrailerDistance
integer <int64>
id
string <uuid>
trailerBrand
string
trailerId
required
string <uuid>
trailerModel
string
trailerRegistration
string
updateDateTime
string <date-time>
updatePersonId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "carBrand": "string",
  • "carId": "566dcc5d-30ab-488e-96e1-c09dec523f18",
  • "carModel": "string",
  • "carRegistration": "string",
  • "coupledDate": "2019-08-24",
  • "coupledDistance": 0,
  • "coupledPersonId": "6c41767c-738c-45d1-85ff-44593d0abedf",
  • "coupledRemarks": "string",
  • "coupledTrailerDistance": 0,
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDate": "2019-08-24",
  • "decoupledDateTime": "2019-08-24T14:15:22Z",
  • "decoupledDistance": 0,
  • "decoupledPersonId": "e8698e97-a658-468a-8bc7-6a9cf8a6f1ac",
  • "decoupledRemarks": "string",
  • "decoupledTrailerDistance": 0,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "trailerBrand": "string",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "trailerModel": "string",
  • "trailerRegistration": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updatePersonId": "069b7006-3570-4408-a633-a325fbeb33e1"
}

Response samples

Content type
application/json
{ }

estimation-controller

getEstimation

path Parameters
vehicleId
required
string <uuid>
query Parameters
date
string <date>

Responses

Response samples

Content type
application/json
{
  • "dailyDistance": 0.1,
  • "distance": 0,
  • "distanceUnit": "KILOMETER",
  • "errorMessage": "string",
  • "status": "OK",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

handover-controller

getAll_6

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_6

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
createDateTime
string <date-time>
createUserId
string <uuid>
handoverId
string <uuid>
handoverState
string (HandoverState)
Enum: "NEW" "WAITING_FOR_DRIVERS_APPROVAL" "WAITING_FOR_MANAGER_APPROVAL" "CLOSED_APPROVED" "CLOSED_REJECTED"
imageIds
Array of strings <uuid> [ items <uuid > ]
incomingDriverApprovalTimestamp
string <date-time>
incomingDriverApproved
boolean
incomingDriverConditionOfVehicleComment
string
incomingDriverId
string <uuid>
managerApprovalTimestamp
string <date-time>
managerApproved
boolean
managerConditionOfVehicleComment
string
managerId
string <uuid>
operationDate
string <date>
organisationId
string
outgoingDriverApprovalTimestamp
string <date-time>
outgoingDriverApproved
boolean
outgoingDriverConditionOfVehicleComment
string
outgoingDriverId
string <uuid>
placeOfTransfer
string
reason
string
trailerChecklistId
string <uuid>
trailerDistance
integer <int32>
trailerId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleChecklistId
string <uuid>
vehicleDistance
integer <int32>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistance": 0,
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistance": 0,
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistanceId": "6ef67421-49f8-4042-bd6c-3208c828216f",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistanceId": "d0447fbf-4ed2-421e-adb1-7c226e9f4b17",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

update_7

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
createDateTime
string <date-time>
createUserId
string <uuid>
handoverId
string <uuid>
handoverState
string (HandoverState)
Enum: "NEW" "WAITING_FOR_DRIVERS_APPROVAL" "WAITING_FOR_MANAGER_APPROVAL" "CLOSED_APPROVED" "CLOSED_REJECTED"
imageIds
Array of strings <uuid> [ items <uuid > ]
incomingDriverApprovalTimestamp
string <date-time>
incomingDriverApproved
boolean
incomingDriverConditionOfVehicleComment
string
incomingDriverId
string <uuid>
managerApprovalTimestamp
string <date-time>
managerApproved
boolean
managerConditionOfVehicleComment
string
managerId
string <uuid>
operationDate
string <date>
organisationId
string
outgoingDriverApprovalTimestamp
string <date-time>
outgoingDriverApproved
boolean
outgoingDriverConditionOfVehicleComment
string
outgoingDriverId
string <uuid>
placeOfTransfer
string
reason
string
trailerChecklistId
string <uuid>
trailerDistance
integer <int32>
trailerId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleChecklistId
string <uuid>
vehicleDistance
integer <int32>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistance": 0,
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistance": 0,
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistanceId": "6ef67421-49f8-4042-bd6c-3208c828216f",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistanceId": "d0447fbf-4ed2-421e-adb1-7c226e9f4b17",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

approve

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
createDateTime
string <date-time>
createUserId
string <uuid>
handoverId
string <uuid>
handoverState
string (HandoverState)
Enum: "NEW" "WAITING_FOR_DRIVERS_APPROVAL" "WAITING_FOR_MANAGER_APPROVAL" "CLOSED_APPROVED" "CLOSED_REJECTED"
imageIds
Array of strings <uuid> [ items <uuid > ]
incomingDriverApprovalTimestamp
string <date-time>
incomingDriverApproved
boolean
incomingDriverConditionOfVehicleComment
string
incomingDriverId
string <uuid>
managerApprovalTimestamp
string <date-time>
managerApproved
boolean
managerConditionOfVehicleComment
string
managerId
string <uuid>
operationDate
string <date>
organisationId
string
outgoingDriverApprovalTimestamp
string <date-time>
outgoingDriverApproved
boolean
outgoingDriverConditionOfVehicleComment
string
outgoingDriverId
string <uuid>
placeOfTransfer
string
reason
string
trailerChecklistId
string <uuid>
trailerDistance
integer <int32>
trailerId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleChecklistId
string <uuid>
vehicleDistance
integer <int32>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistance": 0,
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistance": 0,
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistanceId": "6ef67421-49f8-4042-bd6c-3208c828216f",
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistanceId": "d0447fbf-4ed2-421e-adb1-7c226e9f4b17",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

get_6

path Parameters
handoverId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "handoverId": "67143d15-44f0-4ced-839c-8a3899adfeba",
  • "handoverState": "NEW",
  • "imageIds": [
    ],
  • "incomingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "incomingDriverApproved": true,
  • "incomingDriverConditionOfVehicleComment": "string",
  • "incomingDriverId": "104b6336-56dc-4281-bd24-a3c055c9a73c",
  • "managerApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "managerApproved": true,
  • "managerConditionOfVehicleComment": "string",
  • "managerId": "b2c2c359-55f3-4680-a660-901475c7a693",
  • "operationDate": "2019-08-24",
  • "organisationId": "string",
  • "outgoingDriverApprovalTimestamp": "2019-08-24T14:15:22Z",
  • "outgoingDriverApproved": true,
  • "outgoingDriverConditionOfVehicleComment": "string",
  • "outgoingDriverId": "e2c72071-4035-4433-8231-f4dc75807e4a",
  • "placeOfTransfer": "string",
  • "reason": "string",
  • "trailerChecklistId": "6b6dbbe8-1ea7-4c78-a9a3-46ac52311455",
  • "trailerDistance": 0,
  • "trailerId": "d519e634-43b4-4caf-a685-a90a28153574",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleChecklistId": "f2a8860b-c279-4c31-a168-cacc3decb98e",
  • "vehicleDistance": 0,
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

invite-accept-controller

accept

path Parameters
invitationId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "firstName": "string",
  • "lastName": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "organisationName": "string"
}

maintenance-item-controller

getMaintenanceItems

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createMaintenanceItem

Request Body schema: application/json
required
category
string (MaintenanceItemCategory)
Enum: "AIR_CONDITION" "BREAK" "CLUTCH" "ELECTRICS" "ENGINE" "ENGINE_OIL" "EXHAUST" "LIGHTING" "STEERING" "SUSPENSION" "TRANSMISSION" "TYRE" "TURBO"
description
string
Array of objects (MaintenanceItemDictionary)
distanceConfigurable
boolean
distanceInterval
integer <int32>
enabled
boolean
id
string <uuid>
name
required
string non-empty
organisationId
string <uuid>
timeInterval
integer <int32>
timeIntervalConfigurable
boolean
type
string (MaintenanceItemType)
Enum: "Boolean" "DictionaryRadio" "DictionarySelect"

Responses

Request samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

Response samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

updateMaintenanceItem Deprecated

Request Body schema: application/json
required
category
string (MaintenanceItemCategory)
Enum: "AIR_CONDITION" "BREAK" "CLUTCH" "ELECTRICS" "ENGINE" "ENGINE_OIL" "EXHAUST" "LIGHTING" "STEERING" "SUSPENSION" "TRANSMISSION" "TYRE" "TURBO"
description
string
Array of objects (MaintenanceItemDictionary)
distanceConfigurable
boolean
distanceInterval
integer <int32>
enabled
boolean
id
string <uuid>
name
required
string non-empty
organisationId
string <uuid>
timeInterval
integer <int32>
timeIntervalConfigurable
boolean
type
string (MaintenanceItemType)
Enum: "Boolean" "DictionaryRadio" "DictionarySelect"

Responses

Request samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

Response samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

getMaintenanceItem

path Parameters
itemId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

updateMaintenanceItem_V1_1

Request Body schema: application/json
required
category
string (MaintenanceItemCategory)
Enum: "AIR_CONDITION" "BREAK" "CLUTCH" "ELECTRICS" "ENGINE" "ENGINE_OIL" "EXHAUST" "LIGHTING" "STEERING" "SUSPENSION" "TRANSMISSION" "TYRE" "TURBO"
description
string
Array of objects (MaintenanceItemDictionary)
distanceConfigurable
boolean
distanceInterval
integer <int32>
enabled
boolean
id
string <uuid>
name
required
string non-empty
organisationId
string <uuid>
timeInterval
integer <int32>
timeIntervalConfigurable
boolean
type
string (MaintenanceItemType)
Enum: "Boolean" "DictionaryRadio" "DictionarySelect"

Responses

Request samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

Response samples

Content type
application/json
{
  • "category": "AIR_CONDITION",
  • "description": "string",
  • "dictionary": [
    ],
  • "distanceConfigurable": true,
  • "distanceInterval": 0,
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "timeInterval": 0,
  • "timeIntervalConfigurable": true,
  • "type": "Boolean"
}

prompt-controller

getMaintenancesForOrganisation

header Parameters
organisation-id
required
string <uuid>
Request Body schema: application/json
required
prompt
string

Responses

Request samples

Content type
application/json
{
  • "prompt": "string"
}

Response samples

Content type
application/json
{
  • "response": "string"
}

vehicle-timeline-controller

getTimeLineForVehicle

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

tire-controller

getAll_3

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_3

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

User comment on tire

createDateTime
string <date-time>
createUserId
string <uuid>
dotCode
string

The DOT code (Department of Transportation) is a unique alphanumeric code that indicates the tire manufacturer, plant, size, and production date. The last four digits show the week and year of manufacture, e. g., 2023 means the 20th week of 2023.

organisationId
string
productionDate
string <date>

Tire production date

serialNumber
string

Tire serial number

tagRfid
string

Tire RFID

tireId
string <uuid>
tireLineId
string <uuid>
Array of objects (TireOperationDTO)
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

update_4

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

User comment on tire

createDateTime
string <date-time>
createUserId
string <uuid>
dotCode
string

The DOT code (Department of Transportation) is a unique alphanumeric code that indicates the tire manufacturer, plant, size, and production date. The last four digits show the week and year of manufacture, e. g., 2023 means the 20th week of 2023.

organisationId
string
productionDate
string <date>

Tire production date

serialNumber
string

Tire serial number

tagRfid
string

Tire RFID

tireId
string <uuid>
tireLineId
string <uuid>
Array of objects (TireOperationDTO)
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

addOperation

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
axleNumber
integer <int32>

Axles numered from the front

axlePosition
string (TirePosition)
Enum: "LEFT_OR_LEFT_OUTER" "LEFT_INNER" "RIGHT_INNER" "RIGHT_OR_RIGHT_OUTER"
balanced
boolean

Tire was balanced

comment
string

Tire operation comment

maintenanceId
string <uuid>

Vehicle maintenance when tire operation took place

tireId
string <uuid>
tireLifeCycleStage
string (TireLifeCycleStage)
Enum: "NEW" "INSTALLED" "POSITION_CHANGED" "INSPECTED" "REGROOVED" "REPAIRED" "RETREADED" "UNINSTALLED" "DECOMMISSIONED"
treadDepthLeft
integer <int32>

tread depth left in [mm]

treadDepthMiddle
integer <int32>

tread depth middle in [mm]

treadDepthRight
integer <int32>

tread depth right in [mm]

visibleDamage
boolean

Visual inspection for damage

wheelRimRotation
boolean

Tire is rotated on the rim

Responses

Request samples

Content type
application/json
{
  • "axleNumber": 1,
  • "axlePosition": "LEFT_OR_LEFT_OUTER",
  • "balanced": true,
  • "comment": "New tire",
  • "maintenanceId": "1b89df27-65e7-4fe9-829e-eb29e30ff29a",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLifeCycleStage": "NEW",
  • "treadDepthLeft": 10,
  • "treadDepthMiddle": 11,
  • "treadDepthRight": 12,
  • "visibleDamage": true,
  • "wheelRimRotation": true
}

Response samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

updateOperation

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
axleNumber
integer <int32>

Axles numered from the front

axlePosition
string (TirePosition)
Enum: "LEFT_OR_LEFT_OUTER" "LEFT_INNER" "RIGHT_INNER" "RIGHT_OR_RIGHT_OUTER"
balanced
boolean

Tire was balanced

comment
string

Tire operation comment

maintenanceId
string <uuid>

Vehicle maintenance when tire operation took place

operationId
string <uuid>
tireId
string <uuid>
tireLifeCycleStage
string (TireLifeCycleStage)
Enum: "NEW" "INSTALLED" "POSITION_CHANGED" "INSPECTED" "REGROOVED" "REPAIRED" "RETREADED" "UNINSTALLED" "DECOMMISSIONED"
treadDepthLeft
integer <int32>

tread depth left in [mm]

treadDepthMiddle
integer <int32>

tread depth middle in [mm]

treadDepthRight
integer <int32>

tread depth right in [mm]

visibleDamage
boolean

Visual inspection for damage

wheelRimRotation
boolean

Tire is rotated on the rim

Responses

Request samples

Content type
application/json
{
  • "axleNumber": 2,
  • "axlePosition": "LEFT_OR_LEFT_OUTER",
  • "balanced": true,
  • "comment": "Installed properly",
  • "maintenanceId": "1b89df27-65e7-4fe9-829e-eb29e30ff29a",
  • "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLifeCycleStage": "NEW",
  • "treadDepthLeft": 10,
  • "treadDepthMiddle": 11,
  • "treadDepthRight": 12,
  • "visibleDamage": false,
  • "wheelRimRotation": true
}

Response samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

get_3

path Parameters
tireId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "comment": "Second hand tire",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "dotCode": "DOT T7D3 1BH 3218",
  • "organisationId": "string",
  • "productionDate": "2024-01-20",
  • "serialNumber": "2024-01-20",
  • "tagRfid": "123456789",
  • "tireId": "3619f2ce-ce8f-4b86-abd3-1408e917f6b0",
  • "tireLineId": "8cf7f971-db36-49f3-85ea-90b9e60160e1",
  • "tireOperations": [
    ],
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

line-controller

getAll_5

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_5

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

Additional information about tire line

createDateTime
string <date-time>
createUserId
string <uuid>
lineId
string <uuid>
name
string

The name of the tire line or model

organisationId
string
tireManufactureId
string <uuid>
tireUsage
string (TireUsage)
Enum: "ALL_SEASON" "SUMMER" "WINTER" "MUD_TERRAIN" "HIGHWAY" "SLICK"

Types of tread based on usage

treadPattern
string (TreadPattern)
Enum: "DRIVE" "STEER" "TRAILER" "GENERAL"

One of tire tread patterns

updateDateTime
string <date-time>
updateUserId
string <uuid>
warrantyMileageLimit
integer <int32>

The distance during which a warranty is valid.

warrantyYearsLimit
integer <int32>

The time during which a warranty is valid in years.

Responses

Request samples

Content type
application/json
{
  • "comment": "Good for TGR",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "lineId": "e698cdee-c4ef-4d12-b0ea-7c98b2fc64a8",
  • "name": "Turanza",
  • "organisationId": "string",
  • "tireManufactureId": "48de747f-a9a9-456e-9907-64e5e87d58f2",
  • "tireUsage": "ALL_SEASON",
  • "treadPattern": "DRIVE",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyMileageLimit": 0,
  • "warrantyYearsLimit": 5
}

Response samples

Content type
application/json
{
  • "comment": "Good for TGR",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "lineId": "e698cdee-c4ef-4d12-b0ea-7c98b2fc64a8",
  • "name": "Turanza",
  • "organisationId": "string",
  • "tireManufactureId": "48de747f-a9a9-456e-9907-64e5e87d58f2",
  • "tireUsage": "ALL_SEASON",
  • "treadPattern": "DRIVE",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyMileageLimit": 0,
  • "warrantyYearsLimit": 5
}

update_6

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

Additional information about tire line

createDateTime
string <date-time>
createUserId
string <uuid>
lineId
string <uuid>
name
string

The name of the tire line or model

organisationId
string
tireManufactureId
string <uuid>
tireUsage
string (TireUsage)
Enum: "ALL_SEASON" "SUMMER" "WINTER" "MUD_TERRAIN" "HIGHWAY" "SLICK"

Types of tread based on usage

treadPattern
string (TreadPattern)
Enum: "DRIVE" "STEER" "TRAILER" "GENERAL"

One of tire tread patterns

updateDateTime
string <date-time>
updateUserId
string <uuid>
warrantyMileageLimit
integer <int32>

The distance during which a warranty is valid.

warrantyYearsLimit
integer <int32>

The time during which a warranty is valid in years.

Responses

Request samples

Content type
application/json
{
  • "comment": "Good for TGR",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "lineId": "e698cdee-c4ef-4d12-b0ea-7c98b2fc64a8",
  • "name": "Turanza",
  • "organisationId": "string",
  • "tireManufactureId": "48de747f-a9a9-456e-9907-64e5e87d58f2",
  • "tireUsage": "ALL_SEASON",
  • "treadPattern": "DRIVE",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyMileageLimit": 0,
  • "warrantyYearsLimit": 5
}

Response samples

Content type
application/json
{
  • "comment": "Good for TGR",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "lineId": "e698cdee-c4ef-4d12-b0ea-7c98b2fc64a8",
  • "name": "Turanza",
  • "organisationId": "string",
  • "tireManufactureId": "48de747f-a9a9-456e-9907-64e5e87d58f2",
  • "tireUsage": "ALL_SEASON",
  • "treadPattern": "DRIVE",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyMileageLimit": 0,
  • "warrantyYearsLimit": 5
}

get_5

path Parameters
lineId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "comment": "Good for TGR",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "lineId": "e698cdee-c4ef-4d12-b0ea-7c98b2fc64a8",
  • "name": "Turanza",
  • "organisationId": "string",
  • "tireManufactureId": "48de747f-a9a9-456e-9907-64e5e87d58f2",
  • "tireUsage": "ALL_SEASON",
  • "treadPattern": "DRIVE",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyMileageLimit": 0,
  • "warrantyYearsLimit": 5
}

manufacture-controller

getAll_4

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_4

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

Additional information about tire manufacture

createDateTime
string <date-time>
createUserId
string <uuid>
manufactureId
string <uuid>
name
string

The name of the tire manufacture

organisationId
string
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "comment": "Good manufacture",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "manufactureId": "419e8723-64f8-4e03-a61e-e3e0b6dc353a",
  • "name": "Bridgestone",
  • "organisationId": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "comment": "Good manufacture",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "manufactureId": "419e8723-64f8-4e03-a61e-e3e0b6dc353a",
  • "name": "Bridgestone",
  • "organisationId": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

update_5

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
comment
string

Additional information about tire manufacture

createDateTime
string <date-time>
createUserId
string <uuid>
manufactureId
string <uuid>
name
string

The name of the tire manufacture

organisationId
string
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "comment": "Good manufacture",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "manufactureId": "419e8723-64f8-4e03-a61e-e3e0b6dc353a",
  • "name": "Bridgestone",
  • "organisationId": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "comment": "Good manufacture",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "manufactureId": "419e8723-64f8-4e03-a61e-e3e0b6dc353a",
  • "name": "Bridgestone",
  • "organisationId": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

get_4

path Parameters
manufactureId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "comment": "Good manufacture",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "manufactureId": "419e8723-64f8-4e03-a61e-e3e0b6dc353a",
  • "name": "Bridgestone",
  • "organisationId": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

user-delete-controller

Delete all organisation for logged user

Delete organisation with IAM users is required by Apple Store and Google Play. User need to be the owner (founder) of the organization. If deleted organisation is current organisation, then current organisation is empty. If deleted organisation is only organisation user belong then user belong to no organisation. User belong to one CORPORATE organization is not deleted. For ser belong to other PRIVATE organisation is deleted and for other organisation user initials are saved.

Responses

Response samples

Content type
application/json
{
  • "organisations": [
    ]
}

brand-controller-v-01

getBrands

header Parameters
organisation-id
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createBrand

header Parameters
organisation-id
required
string
Request Body schema: application/json
required
name
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "models": [
    ],
  • "name": "string"
}

getBrand

path Parameters
brandId
required
string <uuid>
header Parameters
organisation-id
required
string

Responses

Response samples

Content type
application/json
{
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "models": [
    ],
  • "name": "string"
}

updateBrand

path Parameters
brandId
required
string <uuid>
header Parameters
organisation-id
required
string
Request Body schema: application/json
required
name
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "models": [
    ],
  • "name": "string"
}

Comments

List comments for a resource

Retrieves paginated list of comments for any resource (task, vehicle, etc.).

Returns active (non-deleted) comments by default, sorted chronologically. Supports pagination via page, size, and sort parameters.

Response includes HATEOAS links for navigation (self, first, next, prev, last). Each comment includes state-driven action links (edit, delete) based on authorization.

Authorizations:
None
path Parameters
contextType
required
string (ContextType)
Enum: "task" "vehicle" "maintenance-order" "fuel-record" "task" "vehicle" "maintenance-order" "fuel-record"
Example: task

Type of parent resource

required
object (ContextId)
Example: 660e8400-e29b-41d4-a716-446655440000

Parent resource identifier

query Parameters
includeDeleted
boolean
Default: false

Include soft-deleted comments

required
object (Pageable)

Pagination parameters (page, size, sort)

header Parameters
required
object (OrganisationId)

Organisation identifier

Responses

Response samples

Content type
application/hal+json
{
  • "_embedded": {
    },
  • "_links": {
    },
  • "page": {
    }
}

type-controller-v-01

getTypes

header Parameters
organisation-id
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createType

header Parameters
organisation-id
required
string
Request Body schema: application/json
required
id
string <uuid>
name
required
string non-empty
organisationId
string <uuid>
trailer
boolean

Responses

Request samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "trailer": true
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "trailer": true
}

getTypeById

path Parameters
typeId
required
string <uuid>
header Parameters
organisation-id
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "trailer": true
}

updateType

path Parameters
typeId
required
string <uuid>
header Parameters
organisation-id
required
string
Request Body schema: application/json
required
id
string <uuid>
name
required
string non-empty
organisationId
string <uuid>
trailer
boolean

Responses

Request samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "trailer": true
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "c9b3f279-e3b5-4204-ad99-646257417f98",
  • "trailer": true
}

vehicle-parameter-get-all-for-organisation-controller

getParameter_1

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

vehicle-parameter-create-for-organisation-controller

createParameter

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
description
string [ 0 .. 256 ] characters
enabled
boolean
id
string <uuid>
name
required
string [ 1 .. 64 ] characters
organisationId
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "string"
}

vehicle-parameter-get-for-vehicle-controller

getParametersForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

vehicle-parameter-value-get-all-for-vehicle-controller

getParameterValuesForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

vehicle-parameter-get-for-organisation-controller

getParameter

path Parameters
organisationId
required
string <uuid>
parameterId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "string"
}

vehicle-parameter-update-for-organisation-controller

updateParameter

path Parameters
organisationId
required
string <uuid>
parameterId
required
string <uuid>
Request Body schema: application/json
required
description
string [ 0 .. 256 ] characters
enabled
boolean
id
string <uuid>
name
required
string [ 1 .. 64 ] characters
organisationId
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "organisationId": "string"
}

telemetry-controller-get-v-01

getTelemetry

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

telemetry-controller-create-v-01

createTelemetry

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
object (TankLevel)
object (TankLevel)
ignition
boolean
latitude
required
number <float>
longitude
required
number <float>
odometer
integer <int32>
operationTimestamp
string <date-time>
speed
number <float>
vehicleId
required
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "catalystLevel": {
    },
  • "fuelLevel": {
    },
  • "ignition": true,
  • "latitude": 0.1,
  • "longitude": 0.1,
  • "odometer": 0,
  • "operationTimestamp": "2019-08-24T14:15:22Z",
  • "speed": 0.1,
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

telemetry-get-for-vehicle-v-01-controller

getTelemetry_1

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>
query Parameters
from
required
string <date-time>
to
required
string <date-time>

Responses

Response samples

Content type
application/json
{
  • "from": "2019-08-24T14:15:22Z",
  • "telemetries": [
    ],
  • "to": "2019-08-24T14:15:22Z"
}

vehicle-parameter-value-update-for-vehicle-controller

updateParameterValueForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>
Request Body schema: application/json
required
description
string
name
string
value
string
vehicleId
string <uuid>
vehicleParameterId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "name": "string",
  • "value": "string",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vehicleParameterId": "74f97355-5ca7-4ed1-97df-b01206485647"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "name": "string",
  • "value": "string",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vehicleParameterId": "74f97355-5ca7-4ed1-97df-b01206485647"
}

vehicle-parameter-value-get-vehicle-controller

getParameterValueForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>
parameterId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "name": "string",
  • "value": "string",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vehicleParameterId": "74f97355-5ca7-4ed1-97df-b01206485647"
}

maintenance-vehicle-indicators-controller-v-02

getVehicleIndicatorsReport_1

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getVehicleIndicatorsReport

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

distance-controller-v-02

createDistance

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
createDateTime
string <date-time>
distance
integer <int64>
distanceType
string (DistanceType)
Enum: "DISTANCE" "MAINTENANCE" "DUTY" "COUPLING" "HANDOVER" "REFUELING"
distanceUnit
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"
externalId
string <uuid>
id
object (DistanceId)
operationDate
string <date>
remarks
string [ 0 .. 1024 ] characters
updateDateTime
string <date-time>
updateUserId
string <uuid>
userId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "distance": 0,
  • "distanceType": "DISTANCE",
  • "distanceUnit": "KILOMETER",
  • "externalId": "3200d382-adfe-4314-ab30-798cdd0fcdb5",
  • "id": { },
  • "operationDate": "2019-08-24",
  • "remarks": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{ }

updateDistance

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
createDateTime
string <date-time>
distance
integer <int64>
distanceType
string (DistanceType)
Enum: "DISTANCE" "MAINTENANCE" "DUTY" "COUPLING" "HANDOVER" "REFUELING"
distanceUnit
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"
externalId
string <uuid>
id
object (DistanceId)
operationDate
string <date>
remarks
string [ 0 .. 1024 ] characters
updateDateTime
string <date-time>
updateUserId
string <uuid>
userId
string <uuid>
vehicleId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "distance": 0,
  • "distanceType": "DISTANCE",
  • "distanceUnit": "KILOMETER",
  • "externalId": "3200d382-adfe-4314-ab30-798cdd0fcdb5",
  • "id": { },
  • "operationDate": "2019-08-24",
  • "remarks": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

Response samples

Content type
application/json
{ }

getDistanceForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

deleteDistance

path Parameters
organisationId
required
string <uuid>
distanceId
required
object (DistanceId)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

getDistance

path Parameters
organisationId
required
string <uuid>
distanceId
required
object (DistanceId)

Responses

Response samples

Content type
application/json
{
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "distance": 0,
  • "distanceType": "DISTANCE",
  • "distanceUnit": "KILOMETER",
  • "externalId": "3200d382-adfe-4314-ab30-798cdd0fcdb5",
  • "id": { },
  • "operationDate": "2019-08-24",
  • "remarks": "string",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

duty-controller-v-02

getDutiesForVehicle

path Parameters
organisationId
required
string <uuid>
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getDuty

path Parameters
organisationId
required
string <uuid>
dutyId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "expirationDate": "2019-08-24",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "imageIds": [
    ],
  • "itemId": "f11b669d-7201-4c21-88af-d85092f0c005",
  • "name": "string",
  • "status": "UNSET",
  • "type": "DATE",
  • "updateTimestamp": "2019-08-24T14:15:22Z",
  • "updateUser": "361e814f-eb1f-4bf2-8c47-35f1bcb2124e",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

updateDuty

path Parameters
organisationId
required
string <uuid>
dutyId
required
string <uuid>
Request Body schema: application/json
required
expirationDate
string <date>
imageIds
Array of strings <uuid> [ items <uuid > ]

Responses

Request samples

Content type
application/json
{
  • "expirationDate": "2019-08-24",
  • "imageIds": [
    ]
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "expirationDate": "2019-08-24",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "imageIds": [
    ],
  • "itemId": "f11b669d-7201-4c21-88af-d85092f0c005",
  • "name": "string",
  • "status": "UNSET",
  • "type": "DATE",
  • "updateTimestamp": "2019-08-24T14:15:22Z",
  • "updateUser": "361e814f-eb1f-4bf2-8c47-35f1bcb2124e",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb"
}

duty-item-controller-v-02

getDutyItems

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

addDutyItem

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
description
string
name
required
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": { },
  • "name": "string"
}

getDutyItem

path Parameters
organisationId
required
string <uuid>
dutyItemId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": { },
  • "name": "string"
}

updateDutyItem

path Parameters
organisationId
required
string <uuid>
dutyItemId
required
string <uuid>
Request Body schema: application/json
required
description
string
name
required
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": { },
  • "name": "string"
}

flight-recorder-controller-v-02

getEpisodes

path Parameters
organisationId
required
string <uuid>
query Parameters
required
object (Pageable)

Responses

Response samples

Content type
application/json
{
  • "content": [
    ],
  • "empty": true,
  • "first": true,
  • "last": true,
  • "number": 0,
  • "numberOfElements": 0,
  • "pageable": {
    },
  • "size": 0,
  • "sort": {
    },
  • "totalElements": 0,
  • "totalPages": 0
}

maintenance-request-report-controller-v-02

getExceedReport_1

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getWarnReport_1

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

maintenance-report-controller-v-02

getExceedReport

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getWarnReport

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

destination-controller-v-03

getDestinationAll

header Parameters
organisation-id
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createDestination

header Parameters
organisation-id
required
string
Request Body schema: application/json
required
dutyItemIds
Array of strings <uuid> [ items <uuid > ]
id
string <uuid>
name
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "dutyItemIds": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "dutyItemIds": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string"
}

getDestination

path Parameters
destinationId
required
string <uuid>
header Parameters
organisation-id
required
string

Responses

Response samples

Content type
application/json
{
  • "dutyItemIds": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string"
}

updateDestination

path Parameters
destinationId
required
string <uuid>
header Parameters
organisation-id
required
string
Request Body schema: application/json
required
dutyItemIds
Array of strings <uuid> [ items <uuid > ]
id
string <uuid>
name
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "dutyItemIds": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "dutyItemIds": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string"
}

maintenance-request-controller-v-03

getAllMaintenanceRequest_1 Deprecated

Responses

Response samples

Content type
application/json
[
  • {
    }
]

getAllMaintenanceRequestForVehicle_1 Deprecated

path Parameters
vehicleId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

createMaintenanceRequest_1 Deprecated

path Parameters
vehicleId
required
string <uuid>
Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceRequestDTOV03)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

getMaintenanceRequest_1 Deprecated

path Parameters
maintenanceRequestId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "atKilometers": 0,
  • "createDate": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "cyclical": true,
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "editDate": "2019-08-24T14:15:22Z",
  • "editUserId": "b8cb20cd-fd09-4975-ad6b-1f7347c2e8ed",
  • "everyDays": 0,
  • "expirationDate": "2019-08-24",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "inspRequest": "string",
  • "status": "UNSET",
  • "vehicleBrand": "string",
  • "vehicleId": "c406adf4-e700-4483-ad7a-e7447a2941cb",
  • "vehicleModel": "string",
  • "vehicleRegistration": "string"
}

updateMaintenanceRequest_1 Deprecated

path Parameters
maintenanceRequestId
required
string <uuid>
Request Body schema: multipart/form-data
file
string <binary>
required
object (MaintenanceRequestDTOV03)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

doneMaintenanceRequest_1 Deprecated

path Parameters
maintenanceRequestId
required
string <uuid>
Request Body schema: application/json
required
done
required
boolean
doneDate
string <date-time>
doneUserId
string <uuid>
id
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Response samples

Content type
application/json
{
  • "done": true,
  • "doneDate": "2019-08-24T14:15:22Z",
  • "doneUserId": "72ce7f1e-7f2a-4fa5-9f68-3495d76fbecd",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

getImageForMaintenance_1 Deprecated

path Parameters
maintenanceRequestId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "violations": [
    ]
}

organisation-controller-v-03

Get user organisations

Returns all enabled organisations for the authenticated user

Responses

Response samples

Content type
application/json
Example

User with enabled organisation

[
  • {
    }
]

createOrganisationForUser

Request Body schema: application/json
required
featureToggles
Array of strings
id
string
imageId
string <uuid>
name
string
type
string (OrganisationType)
Enum: "PRIVATE" "CORPORATE"

Responses

Request samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

Response samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

Get current organisation for user

Returns the currently selected organisation for the authenticated user

Responses

Response samples

Content type
application/json
Example

Corporate organisation

{
  • "id": "c45f2907-9940-4070-9e84-f55d16bfd98c",
  • "name": "Acme Corp Fleet",
  • "type": "CORPORATE",
  • "imageId": null,
  • "featureToggles": [
    ]
}

setCurrentOrganisationForUser

Request Body schema: application/json
required
featureToggles
Array of strings
id
string
imageId
string <uuid>
name
string
type
string (OrganisationType)
Enum: "PRIVATE" "CORPORATE"

Responses

Request samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

Response samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

Delete particular organisation without user

Delete organisation without IAM users. If deleted organisation is current organisation, then current organisation is empty. If deleted organisation is only organisation user belong then user belong to no organisation.

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

getOrganisation

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

updateOrganisationForUser

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
featureToggles
Array of strings
id
string
imageId
string <uuid>
name
string
type
string (OrganisationType)
Enum: "PRIVATE" "CORPORATE"

Responses

Request samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

Response samples

Content type
application/json
{
  • "featureToggles": [
    ],
  • "id": "string",
  • "imageId": "bbefe473-c66a-4040-85cf-1c7e6f0b3830",
  • "name": "string",
  • "type": "PRIVATE"
}

model-controller-query-v-03

getModel

path Parameters
organisationId
required
string <uuid>
modelId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "axesCount": 0,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "maintenanceItemValues": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "name": "string",
  • "selectedVehicleParameters": [
    ],
  • "typeId": "caab7c42-4ce7-4bd5-bbab-6017cec730b7",
  • "typeName": "string",
  • "workUnit": "KILOMETER"
}

getModelsForBrand

path Parameters
organisationId
required
string <uuid>
brandId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

model-controller-command-v-03

createModel

path Parameters
organisationId
required
string <uuid>
Request Body schema: application/json
required
axesCount
integer <int32> [ 2 .. 4 ]
brandId
string <uuid>
required
Array of objects (MaintenanceItemValueDTO)
modelId
string <uuid>
name
required
string non-empty
required
Array of objects (SelectedVehicleParameterDTO)
typeId
required
string <uuid>
typeName
string
workUnit
required
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"

Responses

Request samples

Content type
application/json
{
  • "axesCount": 2,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "maintenanceItemValues": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "name": "string",
  • "selectedVehicleParameters": [
    ],
  • "typeId": "caab7c42-4ce7-4bd5-bbab-6017cec730b7",
  • "typeName": "string",
  • "workUnit": "KILOMETER"
}

Response samples

Content type
application/json
{
  • "axesCount": 0,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "maintenanceItemValues": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "name": "string",
  • "selectedVehicleParameters": [
    ],
  • "typeId": "caab7c42-4ce7-4bd5-bbab-6017cec730b7",
  • "workUnit": "KILOMETER"
}

updateModel

path Parameters
organisationId
required
string <uuid>
modelId
required
string <uuid>
Request Body schema: application/json
required
axesCount
integer <int32> [ 2 .. 4 ]
brandId
string <uuid>
required
Array of objects (MaintenanceItemValueDTO)
modelId
string <uuid>
name
required
string non-empty
required
Array of objects (SelectedVehicleParameterDTO)
typeId
required
string <uuid>
typeName
string
workUnit
required
string (WorkUnit)
Enum: "KILOMETER" "MILE" "HOUR"

Responses

Request samples

Content type
application/json
{
  • "axesCount": 2,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "maintenanceItemValues": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "name": "string",
  • "selectedVehicleParameters": [
    ],
  • "typeId": "caab7c42-4ce7-4bd5-bbab-6017cec730b7",
  • "typeName": "string",
  • "workUnit": "KILOMETER"
}

Response samples

Content type
application/json
{
  • "axesCount": 0,
  • "brandId": "0e9bcbb3-096e-49f9-aeea-7a13a201eff5",
  • "maintenanceItemValues": [
    ],
  • "modelId": "17563eeb-82d7-4210-ac9b-1a20c7d67278",
  • "name": "string",
  • "selectedVehicleParameters": [
    ],
  • "typeId": "caab7c42-4ce7-4bd5-bbab-6017cec730b7",
  • "workUnit": "KILOMETER"
}

duty-report-controller-v-03

getDutyReportForDutyItemId

path Parameters
organisationId
required
string <uuid>
dutyItemId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

maintenances-for-organisation-controller-v-22

getMaintenancesForOrganisation_1

path Parameters
organisationId
required
string <uuid>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

claim-controller

getAll_2

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_2

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
amount
integer <int32>

Amount of product

claimId
string <uuid>
claimState
string (ClaimState)
Enum: "NEW" "SUBMITTED" "RESPONSE_DEADLINE_EXCEED" "CLOSED"
closeReason
string

If available, for traceability.

comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
finalResolution
string (FinalResolution)
Enum: "CANCELED" "REPLACED" "REFUND" "REJECTED"

Final resolution replacement, a repair, or a refund.

internalClaimId
integer <int32>

Unique user friendly claim ID for tracking purposes.

organisationId
string
partSerialNumber
string

If available, for traceability.

preferredResolution
string (Resolution)
Enum: "REPLACE" "REFUND" "WHATEVER"

Whether the customer wants a replacement, a repair, or a refund.

problemDescription
string

Detailed description of the issue or defect with the part.

problemOccurrenceDate
string <date>

When the problem was first noticed.

responseDeadline
string <date>

Supplier response deadline.

submissionDate
string <date>

Date of Claim Submission: The date on which the warranty claim was filed.

submissionUserId
string <uuid>
supplierClaimNumber
string

Supplier claim number.

uninstallationMaintenanceId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleLoadDuringFault
integer <int32>

Vehicle load during fault.

warrantyId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

Response samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

update_2

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
amount
integer <int32>

Amount of product

claimId
string <uuid>
claimState
string (ClaimState)
Enum: "NEW" "SUBMITTED" "RESPONSE_DEADLINE_EXCEED" "CLOSED"
closeReason
string

If available, for traceability.

comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
finalResolution
string (FinalResolution)
Enum: "CANCELED" "REPLACED" "REFUND" "REJECTED"

Final resolution replacement, a repair, or a refund.

internalClaimId
integer <int32>

Unique user friendly claim ID for tracking purposes.

organisationId
string
partSerialNumber
string

If available, for traceability.

preferredResolution
string (Resolution)
Enum: "REPLACE" "REFUND" "WHATEVER"

Whether the customer wants a replacement, a repair, or a refund.

problemDescription
string

Detailed description of the issue or defect with the part.

problemOccurrenceDate
string <date>

When the problem was first noticed.

responseDeadline
string <date>

Supplier response deadline.

submissionDate
string <date>

Date of Claim Submission: The date on which the warranty claim was filed.

submissionUserId
string <uuid>
supplierClaimNumber
string

Supplier claim number.

uninstallationMaintenanceId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
vehicleLoadDuringFault
integer <int32>

Vehicle load during fault.

warrantyId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

Response samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

close_1

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
claimId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947"
}

Response samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

submit

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
claimId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947"
}

Response samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

get_2

path Parameters
claimId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "amount": 3,
  • "claimId": "88057929-7728-4a26-8396-f965dcc8b947",
  • "claimState": "NEW",
  • "closeReason": "Successful resolution",
  • "comment": "Contact person John Doe III",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "finalResolution": "REPLACED",
  • "internalClaimId": 1,
  • "organisationId": "string",
  • "partSerialNumber": "33447871",
  • "preferredResolution": "REPLACE",
  • "problemDescription": "The part got broken during standard exploration.",
  • "problemOccurrenceDate": "2024-11-03",
  • "responseDeadline": "2024-12-01",
  • "submissionDate": "2024-11-10",
  • "submissionUserId": "d600433f-912f-44ee-a51e-8165859cc8b1",
  • "supplierClaimNumber": "56/2024",
  • "uninstallationMaintenanceId": "9808cca7-4ef7-438b-923e-abe59019f83d",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "vehicleLoadDuringFault": 12345,
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

supplier-controller

getAll_1

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create_1

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
city
string
comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
customerNumber
string

Customer number in supplier system

email
string
name
string
organisationId
string
phoneNumber
string
postalCode
string
street
string
supplierId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "city": "string",
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "customerNumber": "12345",
  • "email": "string",
  • "name": "string",
  • "organisationId": "string",
  • "phoneNumber": "string",
  • "postalCode": "string",
  • "street": "string",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "city": "string",
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "customerNumber": "12345",
  • "email": "string",
  • "name": "string",
  • "organisationId": "string",
  • "phoneNumber": "string",
  • "postalCode": "string",
  • "street": "string",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

update_1

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
city
string
comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
customerNumber
string

Customer number in supplier system

email
string
name
string
organisationId
string
phoneNumber
string
postalCode
string
street
string
supplierId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "city": "string",
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "customerNumber": "12345",
  • "email": "string",
  • "name": "string",
  • "organisationId": "string",
  • "phoneNumber": "string",
  • "postalCode": "string",
  • "street": "string",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

Response samples

Content type
application/json
{
  • "city": "string",
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "customerNumber": "12345",
  • "email": "string",
  • "name": "string",
  • "organisationId": "string",
  • "phoneNumber": "string",
  • "postalCode": "string",
  • "street": "string",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

get_1

path Parameters
supplierId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "city": "string",
  • "comment": "Contact person John Doe I",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "customerNumber": "12345",
  • "email": "string",
  • "name": "string",
  • "organisationId": "string",
  • "phoneNumber": "string",
  • "postalCode": "string",
  • "street": "string",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54"
}

warranty-controller

getAll

header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
cloudStorageFolder
string

Store scanned copies of invoices, warranty cards, and other documents in a cloud storage folder for easy access.

comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
expirationDate
string <date>

To check expiration date under warranty coverage.

expirationDistance
integer <int32>

To check expiration distance under warranty coverage.

installationMaintenanceId
string <uuid>
invoiceDate
string <date>
invoiceNumber
string

The original purchase invoice number for verification.

organisationId
string
partDescription
string

Description of the part.

partName
string

Name of the part.

partNumber
string

The specific part number for easy identification.

placeOfPurchase
string

Place of purchase.

purchaseDate
string <date>
registrationDate
string <date>

The date you registered the product with the manufacturer.

registrationNumber
string

If the product required online registration for the warranty, note down the registration confirmation or number.

supplierId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
warrantyId
string <uuid>
warrantyState
string (WarrantyState)
Enum: "NEW" "INSTALLED" "EXPIRED_SOON" "EXPIRED"

Responses

Request samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}

Response samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}

update

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
cloudStorageFolder
string

Store scanned copies of invoices, warranty cards, and other documents in a cloud storage folder for easy access.

comment
string

Additional unstructured comment

createDateTime
string <date-time>
createUserId
string <uuid>
expirationDate
string <date>

To check expiration date under warranty coverage.

expirationDistance
integer <int32>

To check expiration distance under warranty coverage.

installationMaintenanceId
string <uuid>
invoiceDate
string <date>
invoiceNumber
string

The original purchase invoice number for verification.

organisationId
string
partDescription
string

Description of the part.

partName
string

Name of the part.

partNumber
string

The specific part number for easy identification.

placeOfPurchase
string

Place of purchase.

purchaseDate
string <date>
registrationDate
string <date>

The date you registered the product with the manufacturer.

registrationNumber
string

If the product required online registration for the warranty, note down the registration confirmation or number.

supplierId
string <uuid>
updateDateTime
string <date-time>
updateUserId
string <uuid>
warrantyId
string <uuid>
warrantyState
string (WarrantyState)
Enum: "NEW" "INSTALLED" "EXPIRED_SOON" "EXPIRED"

Responses

Request samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}

Response samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}

install

header Parameters
required
object (OrganisationId)
Request Body schema: application/json
required
warrantyId
string <uuid>

Responses

Request samples

Content type
application/json
{
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81"
}

Response samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}

get

path Parameters
warrantyId
required
string <uuid>
header Parameters
required
object (OrganisationId)

Responses

Response samples

Content type
application/json
{
  • "cloudStorageFolder": "/Users/Tecaser/warranty/2024",
  • "comment": "Contact person John Doe II",
  • "createDateTime": "2019-08-24T14:15:22Z",
  • "createUserId": "8a4236c1-1b1a-4524-8e83-af97da191e4a",
  • "expirationDate": "2026-03-10",
  • "expirationDistance": 20000,
  • "installationMaintenanceId": "945bc318-33d1-4968-87e3-4ed9cf91fc00",
  • "invoiceDate": "2019-08-24",
  • "invoiceNumber": "123/2024",
  • "organisationId": "string",
  • "partDescription": "Front brake pad for Volvo TGR 440",
  • "partName": "Front brake pad for TGR 440",
  • "partNumber": "33447871",
  • "placeOfPurchase": "Cracow",
  • "purchaseDate": "2019-08-24",
  • "registrationDate": "2024-04-01",
  • "registrationNumber": "R/123/2024/VLV",
  • "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
  • "updateDateTime": "2019-08-24T14:15:22Z",
  • "updateUserId": "ca111acd-3c55-46ef-9693-09a30ec78a54",
  • "warrantyId": "ceb519c6-3040-4c2c-99a5-9fe694427f81",
  • "warrantyState": "NEW"
}