Get a Service Appointment

Purpose

To fetch a specific service appointment.

Request URL

https://fsm.zoho.com/fsm/v1/Service_Appointments/<record_id>

record_id - The unique ID of the record.

Request Method

GET

Scope

scope=ZohoFSM.modules.ServiceAppointments.READ

Sample Request

Copiedcurl --location --request GET 'https://fsm.zoho.com/fsm/v1/Service_Appointments/1439XXXX4399' \
--header 'Authorization: Zoho-oauthtoken 1000.xxxxxxxxxxxxxxxxx.xxxxxxxd'

Sample Response

Copied{
    "data": [
        {
            "Scheduled_End_Date_Time": "2023-09-29T17:30:00+05:30",
            "Owner": {
                "name": "Diane Lockhart",
                "id": "4776000000223001",
                "email": "lucy.robins@zylker.com"
            },
            "Company": null,
            "Discount": null,
            "$currency_symbol": "$",
            "Actual_Start_Date_Time": null,
            "Cancellation_Reason": null,
            "$Service_Resources": [
                {
                    "name": "Diane Lockhart",
                    "id": "4776000000223235"
                }
            ],
            "Cancelled_Or_Terminated_Time": null,
            "User_Lead": {
                "name": "Lockhart",
                "id": "4776000000223001"
            },
            "Name": "AP-2",
            "Tax_Amount": 2.18,
            "Actual_End_Date_Time": null,
            "Modified_By": {
                "name": "Diane Lockhart",
                "id": "4776000000223001",
                "email": "lucy.robins@zylker.com"
            },
            "Exchange_Rate": 1,
            "Cancellation_Message": null,
            "Currency": "USD",
            "$inactive": false,
            "Service_Address": {
                "Service_Latitude": 13.08268,
                "Service_Street_1": null,
                "Service_State": "Tamil Nadu",
                "Service_Zip_Code": null,
                "name": "AD-11",
                "id": "4776000000230245",
                "Service_Longitude": 80.270718,
                "Service_Address_Name": "Service Address",
                "Service_Street_2": null,
                "Service_Google_Geocodedtime": null,
                "Service_City": null,
                "Service_Country": null
            },
            "Lead": {
                "name": "Diane Lockhart",
                "id": "4776000000223235",
                "user": "4776000000223001"
            },
            "Asset": null,
            "id": "4776000000249126",
            "Discount_Type": null,
            "Status": "Dispatched",
            "Appointments_X_Services": [
                {
                    "Service_Task_Line_Item": null,
                    "Owner": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "Modified_Time": "2023-09-29T16:29:11+05:30",
                    "$currency_symbol": "$",
                    "Created_Time": "2023-09-29T16:29:11+05:30",
                    "$editable": true,
                    "Work_Order": {
                        "name": "WO3",
                        "id": "4776000000249027"
                    },
                    "$permissions": {
                        "read": true,
                        "edit": true,
                        "delete": true
                    },
                    "Name": "WOxAP-2",
                    "Contact": {
                        "name": "Alicia Florrick",
                        "id": "4776000000230219"
                    },
                    "Modified_By": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "Exchange_Rate": 1,
                    "Currency": "USD",
                    "$inactive": false,
                    "Service_Line_Item": {
                        "name": "SVC-4",
                        "id": "4776000000249034"
                    },
                    "Service_Appointment": {
                        "name": "AP-2",
                        "id": "4776000000249126"
                    },
                    "SLI_Status": "Scheduled",
                    "id": "4776000000249138",
                    "Created_By": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "STLI_Status": "Scheduled",
                    "$lineitem_actions": [
                        {
                            "action_name": "start_work",
                            "name": "Start Work"
                        }
                    ]
                },
                {
                    "Service_Task_Line_Item": null,
                    "Owner": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "Modified_Time": "2023-09-29T16:29:11+05:30",
                    "$currency_symbol": "$",
                    "Created_Time": "2023-09-29T16:29:11+05:30",
                    "$editable": true,
                    "Work_Order": {
                        "name": "WO3",
                        "id": "4776000000249027"
                    },
                    "$permissions": {
                        "read": true,
                        "edit": true,
                        "delete": true
                    },
                    "Name": "WOxAP-3",
                    "Contact": {
                        "name": "Alicia Florrick",
                        "id": "4776000000230219"
                    },
                    "Modified_By": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "Exchange_Rate": 1,
                    "Currency": "USD",
                    "$inactive": false,
                    "Service_Line_Item": {
                        "name": "SVC-5",
                        "id": "4776000000249099"
                    },
                    "Service_Appointment": {
                        "name": "AP-2",
                        "id": "4776000000249126"
                    },
                    "SLI_Status": "Scheduled",
                    "id": "4776000000249139",
                    "Created_By": {
                        "name": "Diane Lockhart",
                        "id": "4776000000223001",
                        "email": "lucy.robins@zylker.com"
                    },
                    "STLI_Status": "Scheduled",
                    "$lineitem_actions": [
                        {
                            "action_name": "start_work",
                            "name": "Start Work"
                        }
                    ]
                }
            ],
            "Territory": {
                "name": "Zylker",
                "id": "4776000000223230"
            },
            "Modified_Time": "2023-09-29T16:29:12+05:30",
            "Due_Date": null,
            "Adjustment": null,
            "Created_Time": "2023-09-29T16:29:11+05:30",
            "Sub_Total": 30,
            "$editable": true,
            "Invoice_Id": null,
            "Billing_Status": "Not yet Invoiced",
            "Scheduled_Start_Date_Time": "2023-09-29T16:30:00+05:30",
            "$permissions": {
                "read": true,
                "edit": true,
                "delete": true
            },
            "Contact": {
                "name": "Alicia Florrick",
                "id": "4776000000230219"
            },
            "Preference": {
                "Preferred_Date_1": null,
                "Preferred_Date_2": null,
                "Preference_Note": null,
                "Preferred_Time": null
            },
            "Total": 32.18,
            "Summary": "Leaking faucet",
            "Created_By": {
                "name": "Diane Lockhart",
                "id": "4776000000223001",
                "email": "lucy.robins@zylker.com"
            }
        }
    ]
}