API Reference

Here you will find anything that might be related to the public API Key system

Claim your API Key

Before doing anything, you must claim your API Key to https://chronosrmd.com/api-keys.

Create your API Key from there,

Copy your API key directly. You won't be able to see it again!

Use your API Key

The URL reference to use is https://api.chronosrmd.com/api You must use the Authorization header with "Bearer" in front of it

$ curl -X GET https://api.chronosrmd.com/api/[something]
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"

const apiKey = "YOUR_API_KEY";
fetch("https://api.chronosrmd.com/api/[something]", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

import requests
api_key = "YOUR_API_KEY"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
response = requests.get(
    "https://api.chronosrmd.com/api/[something]",
    headers=headers
)
print(response.json())

Available routes

Here you will find all the available routes through the API with your key. More routes will be added later. Feel free to ask for more in the contact section on the web app !

The idea really is to be able to use Chronos as a third party for your own apps !

Get all your Reminders - /reminders

https://api.chronosrmd/api/reminders

Gives you all your reminders, linked to the account that from the API Key. Comes with the total count of them.

Code 200:

{
  "reminders": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "remind_at_utc": "2024-10-27T15:04:05Z",
      "snoozed_at_utc": "2025-11-08T21:19:28.243Z",
      "next_fire_utc": "2024-10-27T15:04:05Z",
      "message": "Remember to take a break",
      "created_at": "2025-11-08T21:19:28.243Z",
      "recurrence": 0,
      "account": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "timezone_id": 1,
        "created_at": "2025-11-08T21:19:28.243Z",
        "updated_at": "2025-11-08T21:19:28.243Z",
        "timezone": {
          "id": 1,
          "name": "America/New_York",
          "gmt_offset": -5,
          "iana_location": "America/New_York"
        },
        "identities": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "account_id": "123e4567-e89b-12d3-a456-426614174000",
            "provider": "app",
            "external_id": "[email protected]",
            "username": "john_doe",
            "avatar_url": "string",
            "created_at": "2025-11-08T21:19:28.243Z"
          }
        ]
      },
      "destinations": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "reminder_id": "123e4567-e89b-12d3-a456-426614174000",
          "destination_type": "discord_channel",
          "metadata": {
            "channel_id": "987654321",
            "guild_id": "123456789"
          },
          "created_at": "2025-11-08T21:19:28.243Z"
        }
      ]
    }
  ],
  "count": 5
}

Code 401 - Unauthorized : Your API Key must not be set correctly !

Code 500 - Internal Error : Something went wrong, please contact us !

Get reminder details - /reminders/{:id}

https://api.chronosrmd.com/api/reminders/{:id}

This route gives you all the details that you might need for a single reminder

Code 200 -

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "account_id": "123e4567-e89b-12d3-a456-426614174000",
  "remind_at_utc": "2024-10-27T15:04:05Z",
  "snoozed_at_utc": "2025-11-08T21:24:55.556Z",
  "next_fire_utc": "2024-10-27T15:04:05Z",
  "message": "Remember to take a break",
  "created_at": "2025-11-08T21:24:55.556Z",
  "recurrence": 0,
  "account": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "timezone_id": 1,
    "created_at": "2025-11-08T21:24:55.556Z",
    "updated_at": "2025-11-08T21:24:55.556Z",
    "timezone": {
      "id": 1,
      "name": "America/New_York",
      "gmt_offset": -5,
      "iana_location": "America/New_York"
    },
    "identities": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "account_id": "123e4567-e89b-12d3-a456-426614174000",
        "provider": "app",
        "external_id": "[email protected]",
        "username": "john_doe",
        "avatar_url": "string",
        "created_at": "2025-11-08T21:24:55.556Z"
      }
    ]
  },
  "destinations": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "reminder_id": "123e4567-e89b-12d3-a456-426614174000",
      "destination_type": "discord_channel",
      "metadata": {
        "channel_id": "987654321",
        "guild_id": "123456789"
      },
      "created_at": "2025-11-08T21:24:55.556Z"
    }
  ]
}

Code 400 - Bad request : The given id probably doesn't exist

Code 401 - Unauthorized : Your API Key must not be set correctly !

Code 500 - Internal Error : Oops. Something went wrong, please contact me !

Give more freedom for creating reminders with the API

If any of you would like that to implement such a thing in your own application, we'll be glad to add this in the next version, just ask !