All Developer Tools

REST API

Full REST API with natural language and structured endpoints. Schedule cleanings, report issues, manage properties, and coordinate pros programmatically.

Get API KeyFull API Reference

Try It in 30 Seconds

The message_tidy endpoint accepts natural language — just describe what you need.

Request
curl -X POST https://api.tidy.com/v1/message_tidy \
  -H "Authorization: Bearer $TIDY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Book a 2-hour cleaning next Tuesday afternoon at my office"
  }'
Response
{
  "id": "msg_abc123",
  "status": "completed",
  "response": "I've scheduled a 2-hour cleaning for Tuesday March 25 between 1:00 PM and 5:00 PM at 456 Oak Ave. A pro has been assigned and you'll receive a confirmation shortly.",
  "actions_taken": [
    {
      "type": "booking_created",
      "booking_id": 78901,
      "address": "456 Oak Ave",
      "service_type": "regular_cleaning.two_hours",
      "date": "2026-03-25"
    }
  ]
}

Key Endpoints

Base URL: https://api.tidy.com

POST
/v1/message_tidy

Send a natural language request to TIDY. The primary way for agents to interact.

GET
/v1/addresses

List all properties on your account with access instructions.

POST
/v1/bookings

Create a new cleaning booking with time window and service type.

GET
/v1/bookings

List bookings filtered by address, date, or status.

POST
/v1/issues

Report a maintenance issue with urgency and description.

GET
/v1/guest-reservations

List guest reservations with check-in/check-out dates.

GET
/v1/booking-availabilities

Check available time slots and pricing for a property.

GET
/v1/job-acceptance-probabilities/preview

Preview the likelihood of a pro accepting a job at given parameters.

View Full API Reference

Authentication

1

Sign Up

Create an account at tidy.com/create-account

2

Get Token

POST to /v1/customer/login with your email and password

3

Make Requests

Include Authorization: Bearer YOUR_TOKEN in every request

Prefer a Higher-Level Interface?

The MCP server and agent skills wrap this API so your AI agent can use TIDY without any manual HTTP calls.

MCP ServerAgent Skills