{"openapi":"3.1.0","info":{"title":"Intellibook AI — Complete API Reference & Developer Resources (v1)","version":"1.0.0","description":"Complete official v1 REST API, MCP Server, and CLI documentation by Intellibook AI. Automate WhatsApp & Instagram appointment bookings, run Google Business Profile AI audits, track local SEO ranks, manage waitlists, and process Cashfree deposits in India.","contact":{"name":"Intellibook AI Developer Support","email":"support@intellibookai.com","url":"https://www.intellibookai.com/docs"},"license":{"name":"Proprietary","url":"https://www.intellibookai.com/terms"},"x-deprecation-policy":"API v1 is active and guaranteed stable through 2028-01-01. Deprecation policy: https://www.intellibookai.com/docs/api-versioning"},"servers":[{"url":"https://www.intellibookai.com","description":"Production Root Base URL"},{"url":"https://www.intellibookai.com/api/v1","description":"Production v1 API Base URL"}],"tags":[{"name":"businesses","description":"Search and look up registered service businesses"},{"name":"slots","description":"Check real-time available appointment slots"},{"name":"bookings","description":"Create and manage appointment bookings"},{"name":"services","description":"List services offered by a business"},{"name":"staff","description":"Manage staff members and calendars"},{"name":"waitlist","description":"Join waitlist and manage auto slot-fill"},{"name":"gbp","description":"Google Business Profile AI audit and Local SEO tools"},{"name":"billing","description":"Cashfree deposit links and payments"},{"name":"calendar","description":"2-way Google Calendar iCal sync"},{"name":"crm","description":"Customer CRM and conversation history"}],"paths":{"/api/v1/search":{"get":{"operationId":"searchBusinesses","summary":"Search service businesses","tags":["businesses"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"List of matching businesses","headers":{"RateLimit-Limit":{"schema":{"type":"integer","example":100},"description":"Requests per minute allowed"},"RateLimit-Remaining":{"schema":{"type":"integer","example":99},"description":"Remaining requests in window"},"RateLimit-Reset":{"schema":{"type":"integer","example":60},"description":"Seconds until window resets"},"Deprecation":{"schema":{"type":"string","example":"@1830297600"},"description":"API deprecation timestamp"},"Sunset":{"schema":{"type":"string","example":"Sat, 01 Jan 2028 00:00:00 GMT"},"description":"API retirement date"},"Link":{"schema":{"type":"string","example":"<https://www.intellibookai.com/docs/api-versioning>; rel=\"deprecation\""},"description":"Link to deprecation policy"},"API-Version":{"schema":{"type":"string","example":"v1"},"description":"Current API version"}},"content":{"application/json":{"schema":{"type":"object","properties":{"businesses":{"type":"array","items":{"$ref":"#/components/schemas/BusinessSummary"}}}}}}},"400":{"description":"Bad Request — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Resource Not Found — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/v1/slots/{id}":{"get":{"operationId":"getAvailableSlots","summary":"Get available appointment slots","tags":["slots"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"serviceId","in":"query","required":false,"schema":{"type":"integer"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Available time slots","headers":{"RateLimit-Limit":{"schema":{"type":"integer","example":100},"description":"Requests per minute allowed"},"RateLimit-Remaining":{"schema":{"type":"integer","example":99},"description":"Remaining requests in window"},"RateLimit-Reset":{"schema":{"type":"integer","example":60},"description":"Seconds until window resets"},"Deprecation":{"schema":{"type":"string","example":"@1830297600"},"description":"API deprecation timestamp"},"Sunset":{"schema":{"type":"string","example":"Sat, 01 Jan 2028 00:00:00 GMT"},"description":"API retirement date"},"Link":{"schema":{"type":"string","example":"<https://www.intellibookai.com/docs/api-versioning>; rel=\"deprecation\""},"description":"Link to deprecation policy"},"API-Version":{"schema":{"type":"string","example":"v1"},"description":"Current API version"}},"content":{"application/json":{"schema":{"type":"object","properties":{"slots":{"type":"array","items":{"$ref":"#/components/schemas/Slot"}}}}}}},"400":{"description":"Bad Request — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Resource Not Found — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/v1/book/{businessId}":{"post":{"operationId":"createBooking","summary":"Create an appointment booking","tags":["bookings"],"parameters":[{"name":"businessId","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRequest"}}}},"responses":{"200":{"description":"Booking confirmed","headers":{"RateLimit-Limit":{"schema":{"type":"integer","example":100},"description":"Requests per minute allowed"},"RateLimit-Remaining":{"schema":{"type":"integer","example":99},"description":"Remaining requests in window"},"RateLimit-Reset":{"schema":{"type":"integer","example":60},"description":"Seconds until window resets"},"Deprecation":{"schema":{"type":"string","example":"@1830297600"},"description":"API deprecation timestamp"},"Sunset":{"schema":{"type":"string","example":"Sat, 01 Jan 2028 00:00:00 GMT"},"description":"API retirement date"},"Link":{"schema":{"type":"string","example":"<https://www.intellibookai.com/docs/api-versioning>; rel=\"deprecation\""},"description":"Link to deprecation policy"},"API-Version":{"schema":{"type":"string","example":"v1"},"description":"Current API version"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResponse"}}}},"400":{"description":"Bad Request — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Resource Not Found — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/v1/waitlist":{"post":{"operationId":"joinWaitlist","summary":"Join waitlist for fully booked dates","tags":["waitlist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["businessId","customerName","customerPhone"],"properties":{"businessId":{"type":"integer"},"serviceId":{"type":"integer"},"preferredDate":{"type":"string"},"customerName":{"type":"string"},"customerPhone":{"type":"string"}}}}}},"responses":{"200":{"description":"Added to waitlist","headers":{"RateLimit-Limit":{"schema":{"type":"integer","example":100},"description":"Requests per minute allowed"},"RateLimit-Remaining":{"schema":{"type":"integer","example":99},"description":"Remaining requests in window"},"RateLimit-Reset":{"schema":{"type":"integer","example":60},"description":"Seconds until window resets"},"Deprecation":{"schema":{"type":"string","example":"@1830297600"},"description":"API deprecation timestamp"},"Sunset":{"schema":{"type":"string","example":"Sat, 01 Jan 2028 00:00:00 GMT"},"description":"API retirement date"},"Link":{"schema":{"type":"string","example":"<https://www.intellibookai.com/docs/api-versioning>; rel=\"deprecation\""},"description":"Link to deprecation policy"},"API-Version":{"schema":{"type":"string","example":"v1"},"description":"Current API version"}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"position":{"type":"integer"}}}}}},"400":{"description":"Bad Request — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Resource Not Found — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}},"/api/v1/gbp/audit":{"post":{"operationId":"auditGoogleBusinessProfile","summary":"Run AI audit and Local SEO check for Google Business Profile","tags":["gbp"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["businessName"],"properties":{"businessName":{"type":"string"},"city":{"type":"string"}}}}}},"responses":{"200":{"description":"GBP audit and Local SEO report","headers":{"RateLimit-Limit":{"schema":{"type":"integer","example":100},"description":"Requests per minute allowed"},"RateLimit-Remaining":{"schema":{"type":"integer","example":99},"description":"Remaining requests in window"},"RateLimit-Reset":{"schema":{"type":"integer","example":60},"description":"Seconds until window resets"},"Deprecation":{"schema":{"type":"string","example":"@1830297600"},"description":"API deprecation timestamp"},"Sunset":{"schema":{"type":"string","example":"Sat, 01 Jan 2028 00:00:00 GMT"},"description":"API retirement date"},"Link":{"schema":{"type":"string","example":"<https://www.intellibookai.com/docs/api-versioning>; rel=\"deprecation\""},"description":"Link to deprecation policy"},"API-Version":{"schema":{"type":"string","example":"v1"},"description":"Current API version"}},"content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"integer"},"auditResult":{"type":"object"}}}}}},"400":{"description":"Bad Request — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Resource Not Found — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"409":{"description":"Conflict — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error — RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"ProblemDetails":{"type":"object","required":["type","title","status","detail","code","hint"],"properties":{"type":{"type":"string","example":"https://www.intellibookai.com/docs/errors#bad-request"},"title":{"type":"string","example":"Bad Request"},"status":{"type":"integer","example":400},"detail":{"type":"string","example":"Invalid request payload."},"code":{"type":"string","example":"BAD_REQUEST"},"hint":{"type":"string","example":"Verify request parameters in /docs."}}},"BusinessSummary":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string"},"phone":{"type":"string"}}},"Slot":{"type":"object","properties":{"startTime":{"type":"string"},"endTime":{"type":"string"},"available":{"type":"boolean"}}},"BookingRequest":{"type":"object","required":["serviceId","startTime","customerName","customerPhone"],"properties":{"serviceId":{"type":"integer"},"startTime":{"type":"string"},"customerName":{"type":"string"},"customerPhone":{"type":"string"}}},"BookingResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"appointmentId":{"type":"integer"}}}}}}