Documentation

API Reference

Kindaas is a no-auth REST API. Every endpoint returns a single JSON object with a message 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 /randommessage Random message

Returns a random kindness message drawn from the full catalog across all five categories.

Response · 200 OK

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

Example

curl https://kindaas.app/randommessage

GET /{category} By category

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

Path parameter

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

Example

curl https://kindaas.app/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 /personalizemessage Kindness reply

Send any text and receive a kindness message in response. 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/personalizemessage

Response · 200 OK

{
  "message": "Your feelings are valid, and so are you."
}

Reference

Available categories

affirmation Uplifting self-belief messages

emphatic Bold, energetic encouragement

gentle Soft, tender words

gratitude Reflective appreciation

humor Lighthearted messages