API Documentation

Access daily acts of kindness programmatically.

Get All Acts

Retrieve a list of all 365 acts of kindness.

Endpoint

GET https://aok.otd.lol/api/acts

Example Response

[
  {
    "id": 1,
    "dayOfYear": 1,
    "text": "Let someone go ahead of you in line."
  },
  {
    "id": 2,
    "dayOfYear": 2,
    "text": "Pay for the coffee of the person behind you."
  },
  ...
]

Get Today's Act

Retrieve the act of kindness for the current day.

Endpoint

GET https://aok.otd.lol/api/acts/today

Example Response

{
  "id": 250,
  "dayOfYear": 250,
  "text": "Be a cheerleader for someone else's goals."
}

Get Act by Day

Retrieve an act for a specific day of the year (1-365).

Endpoint

GET https://aok.otd.lol/api/acts/{day_of_year}

Example Request

GET https://aok.otd.lol/api/acts/42

Example Response

{
  "id": 42,
  "dayOfYear": 42,
  "text": "Share your lunch with a colleague who forgot theirs."
}

RSS Feed

Subscribe to the daily act via our RSS feed.

Endpoint

https://aok.otd.lol/feed.xml

This endpoint provides an XML feed suitable for RSS readers, updated daily with the latest act.