Appointment API

📄️ Appointment data model

This is the data structure that you will receive every time you are trying to get appointments from our APIs or listening to our events.

📄️ How to create an appointment

This document is designed to help you understand how to create an appointment in myKaarma, what all parameters would you need, how to fetch them and then use them to best suit your use case.

📄️ How to get appointments in myKaarma

This document is designed to help you understand how you can get appointments made in the myKaarma system. Let's get started.

📄️ How to update an appointment

You can update appointments in myKaarma for customer visits so that your Service Advisors are aware of the changed schedule and your customers could be notified/reminded for their scheduled visit.

📄️ How to cancel an appointment

To cancel an appointment, you can simply use the same endpoint that is used to update an appointment. The only parameter that needs to be passed is 'status' with the value "CANCELLED". Please check the example below.

📄️ How to create a draft Appointment

Create a sample draft appointment and generate a short URL for consumer scheduler with pre-filled information.

📄️ How to get resource availabilities

Get the availabilities of advisors, transport options and teams as per the selected attributes including opcodes, recalls, customer and their chosen vehicle for the specified dates.

📄️ How to get the first available slot

Get the first available slot to schedule appointments as per the selected attributes including advisor, transport option, team, opcodes, recalls, customer and their chosen vehicle.

📄️ How to get vacant slot info with rules

This endpoint is deprecated. Please migrate to the updated endpoint getResourceAvailability (/department//availability) by 31st July 2025.

📄️ How to get BrandYear for a Dealer

Get Brand Year for the provided Dealer UUID

📄️ How to save an Opcode

Use the following end point to save an Opcode.

📄️ How to get an appointment by appointment UUID

This document explains how to fetch a single appointment by its appointment UUID.

📄️ How to get appointments by appointment date

This document is designed to help you fetch appointments scheduled on a particular date depending on your use case.

📄️ How to get appointments by filter

This document is designed to help you fetch appointments using filter. This may be helpful in cases where you need to fetch appointments for:

📄️ How to get appointments by order UUID

This document explains how to fetch the appointment (or appointments) linked to a repair order using the order UUID.

📄️ How to get appointments for a customer

This document is designed to help you fetch appointments for a customer depending on your use case.

📄️ How to get eligible Advisor for a dealer

Get service advisor list for which appointment can be scheduled in myKaarma

📄️ How to get TransportOption for a Dealer

Get all transport options for dealer. The response from this API can be cached as transport options rarely change.

📄️ How to get trips for an appointment

This document explains how to fetch pickup and delivery (PnD) trips linked to an appointment. This is useful when you want to view the trip details associated with a specific service appointment.

📄️ How to create an appointment with trip

This document explains how to create an appointment along with a pickup and delivery (PnD) trip in a single API call. This is useful when you want to schedule a service appointment and simultaneously set up a pickup/delivery trip for the customer's vehicle.