# Service VIN — developer & AI platform > One capability registry describes every operation Service VIN can perform, and the REST API, two MCP servers, the Claude connector, the in-app copilot and this documentation are all generated from it. 222 capabilities are published across 25 domains. Nothing here deletes anything or moves money — no capability charges, refunds, pays out, credits, or does anything a write-back cannot undo, on any surface. ## Read this first - [The whole reference as one document](https://www.servicevin.com/developers/llms-full.txt): Every guide and every capability — operating contract, input and output fields, and curl / TypeScript / Python / MCP examples — as one plain-text file. If you are an AI reading this, fetch that instead of crawling the pages. - [Portal home](https://www.servicevin.com/developers): What the platform is, the surfaces it exposes, and where everything is. ## Surfaces - REST resources (`/api/v1`) — live: Leads, customers, vehicles, quotes, invoices, jobs, appointments, messages, services and staff, with cursor pagination and signed webhooks. - Capability endpoints (`/api/v1//`) — shipping: One POST per capability, taking the capability's own input schema and answering with its output shape. - Shop MCP server (`/api/mcp`) — live: Streamable HTTP MCP. Every capability this account may reach, as a tool, filtered by scope, permission, plan and release ring. - Booking MCP server (`/api/mcp/booking`) — live: Availability and booking only, on a fixed allowlist, reached with a booking token — the surface an AI voice platform connects to. - Claude connector (OAuth 2.1) (`/.well-known/oauth-authorization-server`) — live: The same shop server reached through OAuth with dynamic client registration and PKCE, so a shop owner clicks Connect instead of pasting a key. ## Guides - [Getting started](https://www.servicevin.com/developers/guides/getting-started): Mint a key, make your first authenticated call, and understand what a capability is before you call one. - [Authentication](https://www.servicevin.com/developers/guides/authentication): API keys for code you control, and the OAuth connector for a shop owner who clicks Connect. Which to pick, and what each one can reach. - [Pagination](https://www.servicevin.com/developers/guides/pagination): Two paging models, on purpose: an opaque keyset cursor on the REST resources, and an exact remaining count on the capability lists. - [Idempotency](https://www.servicevin.com/developers/guides/idempotency): Every capability declares what a repeat of the same call does — and only one of the three answers needs a key from you. - [Rate limits](https://www.servicevin.com/developers/guides/rate-limits): A per-key window on the REST resources, and four capability budgets whose tightest one exists to protect the shop's sending reputation. - [Errors](https://www.servicevin.com/developers/guides/errors): Success is an envelope and so is failure. Switch on `error.code`; the messages are written for people and may change. - [Webhooks & signature verification](https://www.servicevin.com/developers/guides/webhooks): A signed JSON envelope per event, the exact bytes to verify against, and what happens to an endpoint that keeps failing. - [Connecting Claude](https://www.servicevin.com/developers/guides/connecting-claude): Three ways to point Claude at a shop: the Desktop / claude.ai connector, Claude Code's CLI, and the API's `mcp_servers` parameter. - [Recipes](https://www.servicevin.com/developers/guides/recipes): Three integrations end to end: booking a job from a voice agent, syncing a CRM, and a nightly export. ## Capability domains - [Customers capabilities](https://www.servicevin.com/developers/domains/customers): 10 published, all acting on a customer. - [Vehicles capabilities](https://www.servicevin.com/developers/domains/vehicles): 7 published, all acting on a vehicle. - [Leads capabilities](https://www.servicevin.com/developers/domains/leads): 15 published, all acting on a lead. - [Warranties capabilities](https://www.servicevin.com/developers/domains/warranties): 8 published, all acting on a warranty. - [Quotes capabilities](https://www.servicevin.com/developers/domains/quotes): 10 published, all acting on a quote. - [Invoices capabilities](https://www.servicevin.com/developers/domains/invoices): 13 published, all acting on a invoice. - [Payments capabilities](https://www.servicevin.com/developers/domains/payments): 8 published, all acting on a payment. - [Services capabilities](https://www.servicevin.com/developers/domains/services): 8 published, all acting on a service. - [Jobs capabilities](https://www.servicevin.com/developers/domains/jobs): 11 published, all acting on a job. - [Calendar capabilities](https://www.servicevin.com/developers/domains/calendar): 3 published, all acting on a event. - [Scheduling capabilities](https://www.servicevin.com/developers/domains/scheduling): 7 published, all acting on a slot. - [Staff capabilities](https://www.servicevin.com/developers/domains/staff): 11 published, all acting on a staff. - [Inventory capabilities](https://www.servicevin.com/developers/domains/inventory): 8 published, all acting on a roll. - [Comms capabilities](https://www.servicevin.com/developers/domains/comms): 21 published, all acting on a message. - [Tasks capabilities](https://www.servicevin.com/developers/domains/tasks): 5 published, all acting on a task. - [Shop capabilities](https://www.servicevin.com/developers/domains/shop): 11 published, all acting on a shop. - [Documents capabilities](https://www.servicevin.com/developers/domains/documents): 8 published, all acting on a document. - [Knowledge capabilities](https://www.servicevin.com/developers/domains/knowledge): 5 published, all acting on a article. - [Reports capabilities](https://www.servicevin.com/developers/domains/reports): 12 published, all acting on a report. - [Booking capabilities](https://www.servicevin.com/developers/domains/booking): 12 published, all acting on a booking. - [Forms capabilities](https://www.servicevin.com/developers/domains/forms): 5 published, all acting on a form. - [Marketing capabilities](https://www.servicevin.com/developers/domains/marketing): 5 published, all acting on a campaign. - [Reviews capabilities](https://www.servicevin.com/developers/domains/reviews): 11 published, all acting on a review. - [Automations capabilities](https://www.servicevin.com/developers/domains/automations): 5 published, all acting on a automation. - [Integrations capabilities](https://www.servicevin.com/developers/domains/integrations): 3 published, all acting on a connection. ## Capabilities - [customers.list](https://www.servicevin.com/developers/capabilities/customers.list): Search the customer book by name, email or phone - [customers.get](https://www.servicevin.com/developers/capabilities/customers.get): Get one customer record by id - [customers.find_by_contact](https://www.servicevin.com/developers/capabilities/customers.find_by_contact): Find a customer by exact phone number or email address - [customers.create](https://www.servicevin.com/developers/capabilities/customers.create): Add a new customer to the shop's book - [customers.update](https://www.servicevin.com/developers/capabilities/customers.update): Change one detail on a customer record - [customers.record_consent](https://www.servicevin.com/developers/capabilities/customers.record_consent): Record why this shop may message a customer, and since when - [customers.list_notes](https://www.servicevin.com/developers/capabilities/customers.list_notes): Read the internal notes on a customer - [customers.add_note](https://www.servicevin.com/developers/capabilities/customers.add_note): Add an internal note to a customer record - [customers.consent_standing](https://www.servicevin.com/developers/capabilities/customers.consent_standing): Check whether this shop may still message a customer, and until when - [customers.set_marketing_consent](https://www.servicevin.com/developers/capabilities/customers.set_marketing_consent): Turn marketing messages to a customer on or off - [vehicles.list](https://www.servicevin.com/developers/capabilities/vehicles.list): List the vehicles in a customer's garage, or across the shop - [vehicles.get](https://www.servicevin.com/developers/capabilities/vehicles.get): Get one vehicle by id - [vehicles.find_by_vin](https://www.servicevin.com/developers/capabilities/vehicles.find_by_vin): Find a vehicle by its VIN - [vehicles.create](https://www.servicevin.com/developers/capabilities/vehicles.create): Add a vehicle to a customer's garage - [vehicles.update](https://www.servicevin.com/developers/capabilities/vehicles.update): Change one detail on a vehicle - [vehicles.types](https://www.servicevin.com/developers/capabilities/vehicles.types): List the vehicle size classes this shop prices by - [vehicles.decode_vin](https://www.servicevin.com/developers/capabilities/vehicles.decode_vin): Decode a VIN into the vehicle's year, make, model and size - [leads.list](https://www.servicevin.com/developers/capabilities/leads.list): Search the lead pipeline by name, status, owner or source - [leads.get](https://www.servicevin.com/developers/capabilities/leads.get): Get one whole lead record by id - [leads.statuses](https://www.servicevin.com/developers/capabilities/leads.statuses): List the statuses a lead can be moved through - [leads.assignees](https://www.servicevin.com/developers/capabilities/leads.assignees): List the teammates a lead can be assigned to - [leads.sources](https://www.servicevin.com/developers/capabilities/leads.sources): Break the shop's leads down by where they came from - [leads.intake_health](https://www.servicevin.com/developers/capabilities/leads.intake_health): Check whether every rail is still delivering leads - [leads.find_duplicates](https://www.servicevin.com/developers/capabilities/leads.find_duplicates): Find other leads that look like the same person - [leads.create](https://www.servicevin.com/developers/capabilities/leads.create): Add a new lead to the shop's pipeline - [leads.update](https://www.servicevin.com/developers/capabilities/leads.update): Change one detail on a lead record - [leads.set_status](https://www.servicevin.com/developers/capabilities/leads.set_status): Move one lead to a different pipeline status - [leads.assign](https://www.servicevin.com/developers/capabilities/leads.assign): Give one lead to a teammate, or take its owner off - [leads.add_note](https://www.servicevin.com/developers/capabilities/leads.add_note): Put a note on one lead's timeline - [leads.unanswered](https://www.servicevin.com/developers/capabilities/leads.unanswered): List the open leads nobody has replied to yet, oldest first - [leads.missed_intake](https://www.servicevin.com/developers/capabilities/leads.missed_intake): List the enquiries that arrived but never became a lead - [leads.convert_to_customer](https://www.servicevin.com/developers/capabilities/leads.convert_to_customer): Turn a lead into a customer record with its vehicle - [warranties.list](https://www.servicevin.com/developers/capabilities/warranties.list): Search the warranty registry by customer, expiry or coverage - [warranties.expiry_summary](https://www.servicevin.com/developers/capabilities/warranties.expiry_summary): Count every warranty by whether it is active, expiring or expired - [warranties.certificate](https://www.servicevin.com/developers/capabilities/warranties.certificate): Read what one warranty certificate actually promises - [warranties.claims](https://www.servicevin.com/developers/capabilities/warranties.claims): List the comeback claims raised against the shop's warranty work - [warranties.claim_insights](https://www.servicevin.com/developers/capabilities/warranties.claim_insights): Break the shop's warranty claims down by cause and outcome - [warranties.issue](https://www.servicevin.com/developers/capabilities/warranties.issue): Issue a warranty on a finished job or a paid invoice - [warranties.claim](https://www.servicevin.com/developers/capabilities/warranties.claim): Get one warranty claim with its panels and what it cost - [warranties.followup_queue](https://www.servicevin.com/developers/capabilities/warranties.followup_queue): List every warranty still waiting on its validation inspection - [services.list](https://www.servicevin.com/developers/capabilities/services.list): List the services on the shop's menu and their prices - [services.get](https://www.servicevin.com/developers/capabilities/services.get): Get one service, its price shape and what it needs to run - [services.categories](https://www.servicevin.com/developers/capabilities/services.categories): List the categories the shop's services are grouped under - [services.tiers](https://www.servicevin.com/developers/capabilities/services.tiers): Read a service's price and install time per vehicle size - [services.create](https://www.servicevin.com/developers/capabilities/services.create): Add a new service to the shop's menu with its price - [services.update_price](https://www.servicevin.com/developers/capabilities/services.update_price): Change what a service costs, at one vehicle size or overall - [services.set_online](https://www.servicevin.com/developers/capabilities/services.set_online): Show or hide one service on the public booking page - [services.price_book](https://www.servicevin.com/developers/capabilities/services.price_book): Read the whole service menu with every price in one call - [quotes.list](https://www.servicevin.com/developers/capabilities/quotes.list): List quotes by status, customer or vehicle - [quotes.get](https://www.servicevin.com/developers/capabilities/quotes.get): Get one quote by id, with its totals and dates - [quotes.list_lines](https://www.servicevin.com/developers/capabilities/quotes.list_lines): List the priced lines on a quote - [quotes.statuses](https://www.servicevin.com/developers/capabilities/quotes.statuses): List the statuses a quote can be in - [quotes.catalog](https://www.servicevin.com/developers/capabilities/quotes.catalog): List the services and prices a quote is built from - [quotes.send_status](https://www.servicevin.com/developers/capabilities/quotes.send_status): Check whether a quote can be sent, and by which channel - [quotes.set_status](https://www.servicevin.com/developers/capabilities/quotes.set_status): Move a quote to another status - [quotes.extend_validity](https://www.servicevin.com/developers/capabilities/quotes.extend_validity): Extend how long a quote's price stays good for - [quotes.send](https://www.servicevin.com/developers/capabilities/quotes.send): Text or email a quote to the customer for approval - [quotes.options](https://www.servicevin.com/developers/capabilities/quotes.options): Read the choices and bundle savings offered on one quote - [invoices.list](https://www.servicevin.com/developers/capabilities/invoices.list): List invoices by status, customer or how overdue they are - [invoices.get](https://www.servicevin.com/developers/capabilities/invoices.get): Get one whole invoice, its balance and its terms - [invoices.aging](https://www.servicevin.com/developers/capabilities/invoices.aging): Total every unpaid invoice, split by how overdue it is - [invoices.statement](https://www.servicevin.com/developers/capabilities/invoices.statement): Draw one customer's account statement of invoices and payments - [invoices.create_from_job](https://www.servicevin.com/developers/capabilities/invoices.create_from_job): Raise a draft invoice for the work on one job - [invoices.create_from_quote](https://www.servicevin.com/developers/capabilities/invoices.create_from_quote): Raise an invoice from an accepted quote's agreed totals - [invoices.issue](https://www.servicevin.com/developers/capabilities/invoices.issue): Issue a draft invoice so the balance becomes owed - [invoices.send](https://www.servicevin.com/developers/capabilities/invoices.send): Send one invoice to the customer with a view-and-pay link - [invoices.record_payment](https://www.servicevin.com/developers/capabilities/invoices.record_payment): Record money already received against one invoice - [invoices.void](https://www.servicevin.com/developers/capabilities/invoices.void): Void an invoice that should never have been billed - [invoices.line_items](https://www.servicevin.com/developers/capabilities/invoices.line_items): List what one invoice actually charged for, line by line - [invoices.recovery](https://www.servicevin.com/developers/capabilities/invoices.recovery): List the customer accounts holding an unpaid invoice balance - [invoices.internal_notes](https://www.servicevin.com/developers/capabilities/invoices.internal_notes): Read the shop's private working notes on one invoice - [payments.list](https://www.servicevin.com/developers/capabilities/payments.list): List payments the shop has taken, by invoice, customer or date - [payments.get](https://www.servicevin.com/developers/capabilities/payments.get): Get one payment record and what is left of it - [payments.deposit_status](https://www.servicevin.com/developers/capabilities/payments.deposit_status): Check which booked jobs still owe their deposit payment - [payments.accepted_methods](https://www.servicevin.com/developers/capabilities/payments.accepted_methods): Check which payment methods this shop accepts from a customer - [payments.payout_summary](https://www.servicevin.com/developers/capabilities/payments.payout_summary): Check the shop's card balance and its recent payments out - [payments.tips_collected](https://www.servicevin.com/developers/capabilities/payments.tips_collected): Total the gratuities the shop's payments carried in a period - [payments.disputes](https://www.servicevin.com/developers/capabilities/payments.disputes): List the chargebacks disputing payments this shop took - [payments.dispute](https://www.servicevin.com/developers/capabilities/payments.dispute): Get the chargeback on one payment and its evidence deadline - [jobs.list](https://www.servicevin.com/developers/capabilities/jobs.list): List jobs by stage, customer, vehicle or title - [jobs.get](https://www.servicevin.com/developers/capabilities/jobs.get): Get one job by id, with its schedule and clock - [jobs.stages](https://www.servicevin.com/developers/capabilities/jobs.stages): List the job stages this shop's workflow board runs on - [jobs.timeline](https://www.servicevin.com/developers/capabilities/jobs.timeline): Read what has happened to a job, newest first - [jobs.list_services](https://www.servicevin.com/developers/capabilities/jobs.list_services): List the services and add-ons on a job - [jobs.set_stage](https://www.servicevin.com/developers/capabilities/jobs.set_stage): Move a job to another stage on the workflow board - [jobs.assign](https://www.servicevin.com/developers/capabilities/jobs.assign): Assign a job to a staff member, or unassign it - [jobs.schedule](https://www.servicevin.com/developers/capabilities/jobs.schedule): Rebook a job to a new start and end time - [jobs.set_notes](https://www.servicevin.com/developers/capabilities/jobs.set_notes): Replace the internal notes on a job - [jobs.staff](https://www.servicevin.com/developers/capabilities/jobs.staff): List the staff a job can be assigned to - [jobs.panels](https://www.servicevin.com/developers/capabilities/jobs.panels): Track panel-by-panel progress on one install job - [calendar.day](https://www.servicevin.com/developers/capabilities/calendar.day): List every scheduled event on the shop's board for one day - [calendar.day_capacity](https://www.servicevin.com/developers/capabilities/calendar.day_capacity): Check how many events each day holds against the shop's caps - [calendar.unscheduled](https://www.servicevin.com/developers/capabilities/calendar.unscheduled): List live jobs with no calendar event booked in yet - [scheduling.calendar](https://www.servicevin.com/developers/capabilities/scheduling.calendar): List the booked appointment slots between two dates, earliest first - [scheduling.suggest_slots](https://www.servicevin.com/developers/capabilities/scheduling.suggest_slots): Rank the best slot for a job across bays, installers and margin - [scheduling.stations](https://www.servicevin.com/developers/capabilities/scheduling.stations): List the bays and lifts a slot can be scheduled into - [scheduling.time_off](https://www.servicevin.com/developers/capabilities/scheduling.time_off): List who is off and cannot be given a slot in a window - [scheduling.travel_estimate](https://www.servicevin.com/developers/capabilities/scheduling.travel_estimate): Estimate the drive between two mobile jobs before booking a slot - [scheduling.overbooked_days](https://www.servicevin.com/developers/capabilities/scheduling.overbooked_days): Find the days already booked past the shop's own slot ceiling - [scheduling.readiness](https://www.servicevin.com/developers/capabilities/scheduling.readiness): Check whether this shop can have a slot scheduled at all - [staff.list](https://www.servicevin.com/developers/capabilities/staff.list): List the staff on the roster, their skills and their workload - [staff.get](https://www.servicevin.com/developers/capabilities/staff.get): Get one staff member's record, availability and live work - [staff.certifications](https://www.servicevin.com/developers/capabilities/staff.certifications): List which staff hold which certifications and when they lapse - [staff.roles](https://www.servicevin.com/developers/capabilities/staff.roles): List the roles this shop grants its staff and what each opens - [staff.pay_rates](https://www.servicevin.com/developers/capabilities/staff.pay_rates): Read what the shop's staff are paid, by rate and by type - [staff.timesheet](https://www.servicevin.com/developers/capabilities/staff.timesheet): Read one week of the shop's staff clock, with hours per person - [staff.pay_periods](https://www.servicevin.com/developers/capabilities/staff.pay_periods): Read the shop's recent pay periods and what each staff run came to - [staff.on_the_clock](https://www.servicevin.com/developers/capabilities/staff.on_the_clock): List the staff clocked in right now and what they are working on - [staff.time_off_requests](https://www.servicevin.com/developers/capabilities/staff.time_off_requests): List the time-off requests waiting on a staff manager's answer - [staff.archived](https://www.servicevin.com/developers/capabilities/staff.archived): List the staff profiles archived out of the working roster - [staff.role_matrix](https://www.servicevin.com/developers/capabilities/staff.role_matrix): List each staff role and exactly what it can open and change - [inventory.rolls](https://www.servicevin.com/developers/capabilities/inventory.rolls): List the film rolls on the shelf and how much is left on each - [inventory.skus](https://www.servicevin.com/developers/capabilities/inventory.skus): List the products the shop buys rolls and materials in - [inventory.stock_levels](https://www.servicevin.com/developers/capabilities/inventory.stock_levels): Total the stock left per product across every roll on the shelf - [inventory.valuation](https://www.servicevin.com/developers/capabilities/inventory.valuation): Total what the film rolls on the shelf are worth at cost - [inventory.consumption](https://www.servicevin.com/developers/capabilities/inventory.consumption): Show what came off the rolls, and which job took it - [inventory.purchase_orders](https://www.servicevin.com/developers/capabilities/inventory.purchase_orders): List the purchase orders bringing new rolls and stock in - [inventory.remnants](https://www.servicevin.com/developers/capabilities/inventory.remnants): List the usable offcuts left over from cut film rolls - [inventory.purchase_order](https://www.servicevin.com/developers/capabilities/inventory.purchase_order): Get one purchase order — every roll ordered, and what landed - [documents.list](https://www.servicevin.com/developers/capabilities/documents.list): Search the shop's document library by title, kind or tag - [documents.get](https://www.servicevin.com/developers/capabilities/documents.get): Get one document's details and what happened to it - [documents.for_record](https://www.servicevin.com/developers/capabilities/documents.for_record): List the documents filed against one customer, job or vehicle - [documents.signature_requests](https://www.servicevin.com/developers/capabilities/documents.signature_requests): Check which signature documents are signed, sent or waiting - [documents.readiness](https://www.servicevin.com/developers/capabilities/documents.readiness): Check whether a job's signing document has everything it needs - [documents.timeline](https://www.servicevin.com/developers/capabilities/documents.timeline): Read what has happened to one document — sent, opened, signed - [documents.signature](https://www.servicevin.com/developers/capabilities/documents.signature): Check who signed a document and whether the file still matches - [documents.library_stats](https://www.servicevin.com/developers/capabilities/documents.library_stats): Count what is in the document library and the tags in use - [booking.services](https://www.servicevin.com/developers/capabilities/booking.services): List the services this shop takes online bookings for, with prices - [booking.deposit_policy](https://www.servicevin.com/developers/capabilities/booking.deposit_policy): Check the price and the deposit a booking would require - [booking.availability](https://www.servicevin.com/developers/capabilities/booking.availability): List the open appointment times for a booking, day by day - [booking.hold](https://www.servicevin.com/developers/capabilities/booking.hold): Reserve a slot for a few minutes before taking the booking - [booking.book](https://www.servicevin.com/developers/capabilities/booking.book): Take a booking for a customer at a chosen appointment time - [booking.get](https://www.servicevin.com/developers/capabilities/booking.get): Read one booking back by its manage token - [booking.reschedule](https://www.servicevin.com/developers/capabilities/booking.reschedule): Move an existing booking to a different time - [booking.cancel](https://www.servicevin.com/developers/capabilities/booking.cancel): Cancel a booking, after the customer verifies with a code - [booking.shop_info](https://www.servicevin.com/developers/capabilities/booking.shop_info): Read the opening hours and contact details for a booking caller - [booking.addons](https://www.servicevin.com/developers/capabilities/booking.addons): List the paid extras sold alongside a booking, with their prices - [booking.locations](https://www.servicevin.com/developers/capabilities/booking.locations): List the branches of this business taking booking, and where - [booking.approval_queue](https://www.servicevin.com/developers/capabilities/booking.approval_queue): Count the booking requests waiting for the shop to say yes - [comms.list_calls](https://www.servicevin.com/developers/capabilities/comms.list_calls): List calls by date, direction or outcome, with any voicemail message - [comms.get_call](https://www.servicevin.com/developers/capabilities/comms.get_call): Get one call — direction, outcome, duration and voicemail message - [comms.list_missed_calls](https://www.servicevin.com/developers/capabilities/comms.list_missed_calls): List missed calls and any voicemail message the caller left - [comms.get_call_recording](https://www.servicevin.com/developers/capabilities/comms.get_call_recording): Get a short-lived signed link to a call recording or voicemail message - [comms.get_call_transcript](https://www.servicevin.com/developers/capabilities/comms.get_call_transcript): Read what was said on a call, word for word — speech, not a message - [comms.get_call_analysis](https://www.servicevin.com/developers/capabilities/comms.get_call_analysis): Read a call's AI summary, sentiment and promises made, not its messages - [comms.list_conversations](https://www.servicevin.com/developers/capabilities/comms.list_conversations): List inbox conversations with their latest message and unread state - [comms.get_conversation](https://www.servicevin.com/developers/capabilities/comms.get_conversation): Get one conversation: contact, status, assignee and last message time - [comms.search_messages](https://www.servicevin.com/developers/capabilities/comms.search_messages): Search message text across every conversation in this shop - [comms.update_conversation](https://www.servicevin.com/developers/capabilities/comms.update_conversation): Mark a conversation read, done, pinned or assigned — not its messages - [comms.block_texting](https://www.servicevin.com/developers/capabilities/comms.block_texting): Stop this shop texting one contact — the message opt-out switch - [comms.set_contact_language](https://www.servicevin.com/developers/capabilities/comms.set_contact_language): Set the language this contact's messages are translated into - [comms.list_messages](https://www.servicevin.com/developers/capabilities/comms.list_messages): List messages in one thread, or across the shop, newest first - [comms.get_message](https://www.servicevin.com/developers/capabilities/comms.get_message): Get one message with its delivery status and who sent it - [comms.send_message](https://www.servicevin.com/developers/capabilities/comms.send_message): Send a text message to one customer of this shop - [comms.schedule_message](https://www.servicevin.com/developers/capabilities/comms.schedule_message): Queue a text or email message to a customer for a later time - [comms.list_scheduled_messages](https://www.servicevin.com/developers/capabilities/comms.list_scheduled_messages): List messages queued to send later, soonest first - [comms.cancel_scheduled_message](https://www.servicevin.com/developers/capabilities/comms.cancel_scheduled_message): Pull a scheduled message back before it is sent - [comms.list_phone_numbers](https://www.servicevin.com/developers/capabilities/comms.list_phone_numbers): List the shop's phone numbers — which one calls, which one messages - [comms.get_phone_number](https://www.servicevin.com/developers/capabilities/comms.get_phone_number): Get one of the shop's numbers: status, role and message sending - [comms.resolve_contact](https://www.servicevin.com/developers/capabilities/comms.resolve_contact): Find the customer a number belongs to, and whether we may message them - [tasks.list](https://www.servicevin.com/developers/capabilities/tasks.list): List the shop's inbox tasks — open, overdue, mine or one thread's - [tasks.get](https://www.servicevin.com/developers/capabilities/tasks.get): Get one task with its thread, customer, job and source message - [tasks.assignees](https://www.servicevin.com/developers/capabilities/tasks.assignees): List the teammates a task or a thread can be assigned to - [tasks.create](https://www.servicevin.com/developers/capabilities/tasks.create): Create a task, anchored to a conversation, customer, job or message - [tasks.update](https://www.servicevin.com/developers/capabilities/tasks.update): Change exactly one thing about a task — owner, due date or status - [forms.list](https://www.servicevin.com/developers/capabilities/forms.list): List the shop's lead forms and how many have been submitted - [forms.get](https://www.servicevin.com/developers/capabilities/forms.get): Get one lead form, its steps and what each one asks for - [forms.funnel](https://www.servicevin.com/developers/capabilities/forms.funnel): Show where visitors give up on one lead form, step by step - [forms.connections](https://www.servicevin.com/developers/capabilities/forms.connections): List the third-party forms posting straight into this pipeline - [forms.templates](https://www.servicevin.com/developers/capabilities/forms.templates): List the starter templates a new lead form can be built from - [marketing.offers](https://www.servicevin.com/developers/capabilities/marketing.offers): List the discount campaigns running on the shop's booking page - [marketing.ad_campaigns](https://www.servicevin.com/developers/capabilities/marketing.ad_campaigns): List the shop's imported ad campaigns and their current settings - [marketing.ad_spend](https://www.servicevin.com/developers/capabilities/marketing.ad_spend): Total what each ad campaign spent, and what it brought back - [marketing.share_link_activity](https://www.servicevin.com/developers/capabilities/marketing.share_link_activity): Track which links a campaign or quote sent, and who opened them - [marketing.reactivation_config](https://www.servicevin.com/developers/capabilities/marketing.reactivation_config): Read the rules the automatic win-back campaign texts under - [reviews.list](https://www.servicevin.com/developers/capabilities/reviews.list): List the shop's public reviews and which are still unanswered - [reviews.get](https://www.servicevin.com/developers/capabilities/reviews.get): Get one public review, its text and the shop's reply - [reviews.insights](https://www.servicevin.com/developers/capabilities/reviews.insights): Read the shop's review score, response rate and overdue replies - [reviews.ask_funnel](https://www.servicevin.com/developers/capabilities/reviews.ask_funnel): Measure how many review asks turned into actual reviews - [reviews.unreviewed_asks](https://www.servicevin.com/developers/capabilities/reviews.unreviewed_asks): List customers asked for a review who never left one - [reviews.private_feedback](https://www.servicevin.com/developers/capabilities/reviews.private_feedback): Read the private ratings customers gave without posting a review - [reviews.posts](https://www.servicevin.com/developers/capabilities/reviews.posts): List the posts the shop published beside its reviews on Google - [reviews.reply](https://www.servicevin.com/developers/capabilities/reviews.reply): Publish the shop's reply to one public review - [reviews.request](https://www.servicevin.com/developers/capabilities/reviews.request): Text one customer asking them to leave the shop a review - [reviews.for_customer](https://www.servicevin.com/developers/capabilities/reviews.for_customer): Find what one customer has said in ratings and public reviews - [reviews.settings](https://www.servicevin.com/developers/capabilities/reviews.settings): Read how this shop asks for reviews and routes the unhappy ones - [reports.revenue](https://www.servicevin.com/developers/capabilities/reports.revenue): Read the revenue, profit and margin report for a period - [reports.by_service](https://www.servicevin.com/developers/capabilities/reports.by_service): Break a period's revenue and margin report down by service - [reports.funnels](https://www.servicevin.com/developers/capabilities/reports.funnels): Read the lead and quote conversion report for a period - [reports.marketing](https://www.servicevin.com/developers/capabilities/reports.marketing): Read the report of what each lead source cost and returned - [reports.install](https://www.servicevin.com/developers/capabilities/reports.install): Read the installer and film-usage report for a period - [reports.job_pl](https://www.servicevin.com/developers/capabilities/reports.job_pl): Read the per-job profit-and-loss report for completed work - [reports.sla](https://www.servicevin.com/developers/capabilities/reports.sla): Read the first-response speed report for the shop's leads - [reports.tax](https://www.servicevin.com/developers/capabilities/reports.tax): Read the sales-tax report of what was charged and collected - [reports.dashboard](https://www.servicevin.com/developers/capabilities/reports.dashboard): Read today's dashboard report — money in, and who is waiting - [reports.metrics](https://www.servicevin.com/developers/capabilities/reports.metrics): Read the whole business report card, metric by metric - [reports.insights](https://www.servicevin.com/developers/capabilities/reports.insights): List the advisor's report on what to fix in this business - [reports.recovered_revenue](https://www.servicevin.com/developers/capabilities/reports.recovered_revenue): Read the report on money the AI front desk won back - [automations.list](https://www.servicevin.com/developers/capabilities/automations.list): List the shop's automation rules and which are armed - [automations.activity](https://www.servicevin.com/developers/capabilities/automations.activity): Show what the shop's automations actually did, and to whom - [automations.templates](https://www.servicevin.com/developers/capabilities/automations.templates): List the automation templates a shop could switch on - [automations.coverage](https://www.servicevin.com/developers/capabilities/automations.coverage): Find the moments where no automation tells anybody anything - [automations.get](https://www.servicevin.com/developers/capabilities/automations.get): Read one automation step by step — what it sends, and when - [shop.profile](https://www.servicevin.com/developers/capabilities/shop.profile): Read the shop's name, timezone, currency, address and booking link - [shop.playbook](https://www.servicevin.com/developers/capabilities/shop.playbook): Read the shop's own playbook for one of its AI agents - [shop.business_hours](https://www.servicevin.com/developers/capabilities/shop.business_hours): Read the days and hours this shop is open for work - [shop.booking_config](https://www.servicevin.com/developers/capabilities/shop.booking_config): Read how this shop takes bookings, deposits and approvals - [shop.branding](https://www.servicevin.com/developers/capabilities/shop.branding): Read the shop's logo and accent colour as customers see them - [shop.locations](https://www.servicevin.com/developers/capabilities/shop.locations): List the other locations in this shop's organization - [shop.agents](https://www.servicevin.com/developers/capabilities/shop.agents): List this shop's AI agents, which are on and how they send - [shop.messaging_config](https://www.servicevin.com/developers/capabilities/shop.messaging_config): Read whether the shop may text, and inside which hours - [shop.plan](https://www.servicevin.com/developers/capabilities/shop.plan): Read the shop's plan, trial state and what it includes - [shop.ai_credits](https://www.servicevin.com/developers/capabilities/shop.ai_credits): Check how many AI credits this shop has left to spend - [shop.setup_progress](https://www.servicevin.com/developers/capabilities/shop.setup_progress): Check how far this shop is through setting itself up - [integrations.list](https://www.servicevin.com/developers/capabilities/integrations.list): List every connection this shop has linked, and to what - [integrations.health](https://www.servicevin.com/developers/capabilities/integrations.health): Check whether the shop's connections are still working - [integrations.available](https://www.servicevin.com/developers/capabilities/integrations.available): List the connections this shop could link, and what each does - [knowledge.list](https://www.servicevin.com/developers/capabilities/knowledge.list): List the shop-memory articles the shop's AI is grounded on - [knowledge.capacity](https://www.servicevin.com/developers/capabilities/knowledge.capacity): Check how much shop-memory article space this plan allows - [knowledge.playbook](https://www.servicevin.com/developers/capabilities/knowledge.playbook): List the playbook articles the team uses to answer customers - [knowledge.grounding](https://www.servicevin.com/developers/capabilities/knowledge.grounding): Read the article set an AI agent is actually grounded on here - [knowledge.brief](https://www.servicevin.com/developers/capabilities/knowledge.brief): Read the shop's own brief — the article every agent starts from ## Machine surfaces - [OpenAPI 3.1](https://www.servicevin.com/developers/openapi.json): The REST surface, generated from the same spec the route handlers are checked against. - [MCP discovery](https://www.servicevin.com/developers/.well-known/mcp.json): Both servers described for discovery — transport, auth and purpose. - [Changelog](https://www.servicevin.com/developers/changelog): What appeared, and what an older capability id resolves to now.