# CleanLife Partner API

> Developer portal for CleanLife Partner API integrations.

## Docs

- [Authentication](https://docs.thecleanlife.dev/authentication.md): API Key authentication, permissions model, domain allowlist, and security.
- [Best Practices](https://docs.thecleanlife.dev/best-practices.md): Retry strategy, timeouts, idempotency, logging, security, and performance.
- [Business Rules](https://docs.thecleanlife.dev/business-rules.md): Hidden business logic: payment flows, booking states, cancellation rules.
- [Changelog](https://docs.thecleanlife.dev/changelog.md): Release history and versioning policy.
- [Cancel Booking](https://docs.thecleanlife.dev/endpoints/bookings/cancel-booking.md): PATCH /partners/bookings/:id/cancel — Cancel a booking.
- [Confirm Payment](https://docs.thecleanlife.dev/endpoints/bookings/confirm-payment.md): POST /partners/bookings/:id/confirm-payment — Confirm payment.
- [Create Booking](https://docs.thecleanlife.dev/endpoints/bookings/create-booking.md): POST /partners/bookings — Create a new booking.
- [Get Booking Status](https://docs.thecleanlife.dev/endpoints/bookings/get-booking-status.md): GET /partners/bookings/:id/status — Get booking status.
- [List Bookings](https://docs.thecleanlife.dev/endpoints/bookings/list-bookings.md): GET /partners/bookings — List and filter bookings.
- [Update Booking](https://docs.thecleanlife.dev/endpoints/bookings/update-booking.md): PATCH /partners/bookings/:id — Update booking date/timeslot.
- [Calculate Price](https://docs.thecleanlife.dev/endpoints/catalog/calculate-price.md): POST /partners/pricing/calculate-price — Preview booking cost.
- [Get Pricing Tiers](https://docs.thecleanlife.dev/endpoints/catalog/get-pricing-tiers.md): GET /partners/pricing/tiers — Get active pricing tiers.
- [Get Service](https://docs.thecleanlife.dev/endpoints/catalog/get-service.md): GET /partners/services/:id — Get a single service category.
- [Get Timeslots](https://docs.thecleanlife.dev/endpoints/catalog/get-timeslots.md): GET /partners/timeslots/available — Get available timeslots.
- [List Services](https://docs.thecleanlife.dev/endpoints/catalog/list-services.md): GET /partners/services — List available service categories.
- [Find or Create Contact](https://docs.thecleanlife.dev/endpoints/contacts/find-or-create-contact.md): POST /partners/contacts — Get contactId for booking (find existing or create new).
- [Get Contact by ID](https://docs.thecleanlife.dev/endpoints/contacts/get-contact-by-id.md): GET /partners/contacts/:contactId — Retrieve a contact by UUID.
- [Create Subscription](https://docs.thecleanlife.dev/endpoints/webhooks/create-subscription.md): POST /partners/webhooks/subscriptions — Subscribe to events.
- [Delete Subscription](https://docs.thecleanlife.dev/endpoints/webhooks/delete-subscription.md): DELETE /partners/webhooks/subscriptions/:id — Remove subscription.
- [List Deliveries](https://docs.thecleanlife.dev/endpoints/webhooks/list-deliveries.md): GET /partners/webhooks/deliveries — List delivery history.
- [List Subscriptions](https://docs.thecleanlife.dev/endpoints/webhooks/list-subscriptions.md): GET /partners/webhooks/subscriptions — List subscriptions.
- [Retry Delivery](https://docs.thecleanlife.dev/endpoints/webhooks/retry-delivery.md): POST /partners/webhooks/deliveries/:id/retry — Retry delivery.
- [Rotate Secret](https://docs.thecleanlife.dev/endpoints/webhooks/rotate-secret.md): POST /partners/webhooks/subscriptions/:id/rotate-secret.
- [Update Subscription](https://docs.thecleanlife.dev/endpoints/webhooks/update-subscription.md): PATCH /partners/webhooks/subscriptions/:id — Update a subscription.
- [Getting Started](https://docs.thecleanlife.dev/getting-started.md): Prerequisites, API key setup, and making your first API call.
- [CleanLife Partner API](https://docs.thecleanlife.dev/index.md): Complete developer portal for CleanLife Partner API integrations.
- [Integration Flows](https://docs.thecleanlife.dev/integration-flow.md): Sequence diagrams for PARTNER, CLEANOS, cancellation, and webhook flows.
- [Introduction](https://docs.thecleanlife.dev/introduction.md): What the API is, who should use it, base URL, versioning, and timezones.
- [Enums Reference](https://docs.thecleanlife.dev/models/enums.md): Complete reference for all enum values used in the Partner API.
- [Request Models](https://docs.thecleanlife.dev/models/request-models.md): All request body schemas with field-level types, validation, and descriptions.
- [Response Models](https://docs.thecleanlife.dev/models/response-models.md): All response shapes with full field descriptions.
- [Rate Limits](https://docs.thecleanlife.dev/rate-limits.md): Sliding window rate limiting, retry strategy, and best practices.
- [Request Standards](https://docs.thecleanlife.dev/request-format.md): HTTP methods, pagination, sorting, date formats, and idempotency.
- [Response Format](https://docs.thecleanlife.dev/response-format.md): Success and error response envelopes with full field descriptions.
- [SDK Examples](https://docs.thecleanlife.dev/sdk-examples.md): Complete code examples in cURL, JavaScript, TypeScript, Python, C#, and PHP.
- [Webhooks](https://docs.thecleanlife.dev/webhooks.md): Full webhook guide: events, delivery, signature verification, retry policy.