Documentation

API Reference

Kindaas is a no-auth REST API. Quote endpoints return a single JSON object with a message field, and the reply endpoint adds a category field. No API key. No setup. Just HTTP.

Base URL https://kindaas.app

GET /health Health check

Returns {"status":"ok"} when the service is running. Use this for health probes or uptime monitoring.

Response · 200 OK

{ "status": "ok" }

Example

curl https://kindaas.app/health

GET /quotes Random quote

Returns a random kindness quote drawn from the full catalog across all five categories. You can optionally filter by category with a query parameter.

Query parameter

Param	Type	Required	Description
`category`	string	No	Optional filter for one of the five tone values

Response · 200 OK

{
  "message": "You are doing better than you think."
}

Example

curl https://kindaas.app/quotes

GET /quotes?category={category} By category

Returns a random quote filtered to the specified emotional tone. See Available categories for valid values.

Query parameter

Param	Type	Required	Description
`category`	string	Yes	One of the five tone values

Example

curl "https://kindaas.app/quotes?category=gentle"

Response · 200 OK

{
  "message": "Take a soft breath; this moment does not need to be rushed."
}

Error · 422 Unprocessable Entity

{ "detail": [{ "msg": "Input should be …" }] }

POST /reply Kindness reply

Send any text and receive a kindness reply in response. The API predicts a tone category, then selects a quote from that bucket. Ideal for chatbots, journaling apps, or any interactive experience.

Request body · application/json

Field	Type	Required	Description
`text`	string	Yes	Free-form user text (min 1 char)

Example

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"text": "I had a rough day."}' \
  https://kindaas.app/reply

Response · 200 OK

{
  "message": "You can be gentle with yourself while you figure things out.",
  "category": "gentle"
}

Reference

Available categories

affirmation Uplifting self-belief messages

emphatic Bold, energetic encouragement

gentle Soft, tender words

gratitude Reflective appreciation

humor Lighthearted messages