Developers

CleanForge Public API

CleanForge provides recurring 6-weekly exterior window cleaning in South West London. The public API helps developers, AI agents, GPT Actions, MCP clients, automation tools, and future customer applications discover what CleanForge can currently support.

API v1 Discovery, capabilities, pricing estimates, and quote requests

Booking automation and GoCardless payment setup are not available through the public API yet.

Discovery

Start with the discovery documents

Public API v1 is available at /api/v1. Capabilities can be discovered at /api/v1/capabilities, and OpenAPI is available at /openapi.json.

Capabilities

/api/v1/capabilities

Machine-readable service support, business rules, pricing rules, and unsupported capabilities.

Health

/api/v1/health

Lightweight public API health check without a database check.

Service Areas

/api/v1/service-areas

Machine-readable supported and planned postcode districts.

Postcode Lookup

/api/v1/postcode/SW19%202AB

Example postcode lookup for service-area support.

Quote Requests

/api/v1/quote-requests

POST endpoint for agent-compatible recurring window-cleaning quote requests.

OpenAPI

/openapi.json

Primary OpenAPI specification for the public API.

Well-Known OpenAPI

/.well-known/openapi.json

Well-known OpenAPI location for discovery tools.

API Catalog

/.well-known/api-catalog

Linkset catalog for machine discovery of API documents.

Agent Skills

/.well-known/agent-skills/index.json

Machine-readable list of practical CleanForge agent skills.

llms.txt

/llms.txt

Plain-text guidance for AI agents and browsing tools.

Quote requests

Agent-compatible quote intake

Agents may submit quote requests using POST /api/v1/quote-requests. The endpoint accepts JSON, supports idempotency keys, and stores requests in the existing CleanForge Ops lead and quote pipeline.

  • Recurring exterior window cleaning, including frames and sills
  • 6-weekly service frequency
  • South West London availability reviewed per address
  • Booking and payment setup are not public API features yet