Home > Documentation

Entries

This endpoint lets you manage entries in your journals.

Entries are daily records in your journals. Each entry is associated with a specific date and journal.

When you request an entry for a specific date, it will either create a new one or return an existing one.

Once an entry is created, it can not be deleted.

The Entry object

This object represents an entry in your journal.

Attributes

id integer

The ID of the entry.

object string

The object type. Always 'entry'.

journal_id integer

The ID of the journal this entry belongs to.

day integer

The day of the month (1-31).

month integer

The month (1-12).

year integer

The year.

created_at integer

The date and time the object was created, in Unix timestamp format.

updated_at integer

The date and time the object was last updated, in Unix timestamp format.

Example
{
"data": {
"id": 1 ,
"object": "entry" ,
"journal_id": 1 ,
"day": 1 ,
"month": 1 ,
"year": 2024 ,
"created_at": 1710086400 ,
"updated_at": 1710086400
}
}

Get entry by date

This endpoint retrieves or creates an entry for a specific date. If an entry already exists for the given date, it will be returned. Otherwise, a new entry will be created.

URL parameters

journal_id integer required

The ID of the journal the entry belongs to.

year integer required

The year of the entry.

month integer required

The month of the entry (1-12).

day integer required

The day of the entry (1-31).

Query parameters

No query parameters are available for this endpoint.

Response attributes

data object

The requested or newly created entry object.

GET /api/journals/{journal_id}/entries/{year}/{month}/{day}
{
"data": {
"id": 1 ,
"object": "entry" ,
"journal_id": 1 ,
"day": 1 ,
"month": 1 ,
"year": 2024 ,
"created_at": 1710086400 ,
"updated_at": 1710086400
}
}
Taylor Swift being happy

Please login to vote.

It's free and will help us improve the page.

Taylor will be proud of you.

Last updated on April 5, 2025.