My Otovo
get_my_otovo
Reads what a customer can see in their Otovo portal, one view at a time. Changes nothing. With a scheduling code and no account, three views: booking_status (the address, services offered, the visit already scheduled and whether it can be moved or cancelled, open access questions, the support line), booking_options (code and service_type, optional week_start, location_id and promo_code: bookable times for a new visit, best first, with the price and what the promo code does) and reschedule_options (code, optional week_start: times the scheduled visit can move to). With a connected account, site_id selects one of the customer's sites when they have several: sites, profile, home, summary; monitoring (production now, equipment status, alerts and when each reading was taken; a missing or stale reading is not zero production), monitoring_page, monitoring_history (node_id, query range day|week|month|year and date), monitoring_devices (node_id), monitoring_device (node_id, device_id), monitoring_energy_rate; connect_system (the monitoring providers Otovo connects, the fields each connection needs and the portal's setup steps; id = one provider); energy, energy_usage (query start_date, end_date, granularity), energy_bills, energy_plans; service (visits, work orders, bookable services), appointment (id), appointment_tracking (id: where the crew is on the day), scheduling (what can be booked or moved, open access questions), booking_options (service_type, optional week_start and promo_code) and reschedule_options (optional week_start); work_order (id), repair (id), site_report (id; photos stay in the portal); quotes, quote (id); billing, billing_records (query limit, cursor), billing_record (id; the invoice PDF is a portal link), payment_methods, subscription, subscription_plans, subscription_terms (query tier, billing_interval); documents (pending, signed, project and historical); leases, lease (id); hour_bank; notification_settings. Reading booking times for a connected customer can create their own Otovo scheduler link; nothing is sent to them. Serves every Otovo region: without a connected account the scheduling code, preview or address selects the region; a connected customer is served where their account lives.
Schema valid · SHA-256 d0986f17cd8c…
View input schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Without an account: the customer's scheduling code, the last part of the otovo.com/book/... link they were sent. It cannot be looked up from other details."
},
"device_id": {
"type": "string",
"description": "A device from view monitoring_devices (monitoring_device)."
},
"id": {
"type": "string",
"description": "The record a single-record view is about: an appointment, work order, site report, quote, billing record (its quote id), lease (project id), or a provider key for connect_system."
},
"location_id": {
"type": "string",
"description": "booking_options: which property, when the booking covers more than one."
},
"node_id": {
"type": "string",
"description": "A monitoring node from view monitoring (monitoring_history, monitoring_devices, monitoring_device)."
},
"promo_code": {
"type": "string",
"description": "booking_options: a promo code the customer gave. The answer's charge is the price with it and promo says whether it applied, their Otovo Care discount is larger, or why it was refused."
},
"query": {
"type": "object",
"description": "Extra filters the view takes, as named in the description: for example {\"range\":\"month\",\"date\":\"2026-10-01\"} for monitoring_history, {\"limit\":20} for billing_records, {\"tier\":\"care\"} for subscription_terms."
},
"service_type": {
"type": "string",
"description": "booking_options: the kind of new visit. booking_status or view scheduling lists what is actually offered.",
"enum": [
"panel_cleaning",
"inspection",
"inspection_roof",
"inspection_panel_cleaning",
"inspection_roof_panel_cleaning",
"generator",
"project_consultation"
]
},
"site_id": {
"type": "string",
"description": "Connected customers: one of their own sites, a site_id from view sites. Needed when they have more than one."
},
"view": {
"type": "string",
"description": "What to read. See the tool description for what each view holds and which parameters it takes.",
"enum": [
"sites",
"profile",
"home",
"summary",
"monitoring",
"monitoring_page",
"monitoring_history",
"monitoring_devices",
"monitoring_device",
"monitoring_energy_rate",
"connect_system",
"energy",
"energy_usage",
"energy_bills",
"energy_plans",
"service",
"appointment",
"appointment_tracking",
"scheduling",
"booking_status",
"booking_options",
"reschedule_options",
"work_order",
"repair",
"site_report",
"quotes",
"quote",
"billing",
"billing_records",
"billing_record",
"payment_methods",
"subscription",
"subscription_plans",
"subscription_terms",
"documents",
"leases",
"lease",
"hour_bank",
"notification_settings"
]
},
"week_start": {
"type": "string",
"description": "booking_options, reschedule_options: earliest date to search from, YYYY-MM-DD. Step it forward a week at a time to look further out."
}
},
"required": [
"view"
],
"additionalProperties": false
}