Skip to main content

Get User Posts By Day

GET /:username/posts/:date

Description

Returns a paginated list of a user's posts for a specific day.

The date route param expects DD-MM-YYYY. If it is invalid, the API falls back to the viewer's current day.

Request Parameters

Requires Authentication: true

PATH PARAMS

NameTypeRequiredDescription
usernamestringYesTarget username.
datestringYesDay in DD-MM-YYYY format.

QUERY PARAMS

NameTypeRequiredDescription
pagenumberNoPage number. Defaults to 1.
maxPageSizenumberNoPage size. The API caps it at the shared max page size.
orderstringNoOptional sort mode. Defaults to relevant.

Usage Example

await axios.get(
"https://api.daykeeper.app/johndoe/posts/18-03-2026?page=1",
{
headers: {
Authorization: `Bearer ${accessToken}`,
},
}
)

Success Response

{
"message": "posts fetched successfully",
"data": [
{
"_id": "67d9c0d4cc9e4db02fca1001",
"description": "A post from that day"
}
],
"page": 1,
"pages": 1
}

Error Response

CodeDescription
401Missing or invalid access token
404User not found
500Server error