API overview

Base URL and discovery

All version 1 routes use this base URL:

https://lawncare.center/api/v1

Request the base route to discover capabilities:

curl https://lawncare.center/api/v1

The OpenAPI 3.1 document is available at https://lawncare.center/api/v1/openapi.json.

Response format

Successful responses put the result in data and response details in meta. Search responses also include the total match count and may include a pagination cursor.

{
  "data": [],
  "meta": {
    "catalogVersion": "...",
    "total": 0
  }
}

Errors use a stable code and a readable message:

{
  "error": {
    "code": "invalid_request",
    "message": "..."
  }
}

Authentication, CORS, and caching

No API key is required. The API only returns published public content and supports cross-origin GET requests.

Responses include ETags and shared-cache directives. Send If-None-Match when you retain a prior ETag. Content changes take effect after a site deployment.

Rate limit

Production currently limits /api/v1 traffic to 120 requests per minute per IP address. Back off after a 429 response and cache results where appropriate.