Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/akevalion/life_cost/llms.txt

Use this file to discover all available pages before exploring further.

Return every money transfer that occurred on a specific local calendar day within the authenticated user’s active wallet. The server converts the supplied date to the client’s timezone, computes the UTC-equivalent midnight-to-midnight window, and queries the database with those UTC bounds. Results are ordered by transfer ID descending (newest first) and include the same full transfer shape as the other list endpoints. This endpoint is designed for the daily view in the Life Cost UI, where a user taps a day in the calendar and sees all transactions for that day in their local time.

​
Endpoint

POST /money_transfer_from_date

​
Authentication

Required. The request must be made with an active session cookie obtained through the Google OAuth login flow.

​
Request Body

​
timeZone
string
required
An IANA timezone identifier string (e.g. "America/New_York", "Europe/Madrid", "Asia/Tokyo"). Used to localise the supplied date and to define the day boundaries before converting to UTC for the database query.
​
date
string
required
An ISO 8601 date-time string representing any moment within the target day (e.g. "2024-01-15T00:00:00Z" or "2024-01-15T12:00:00+05:30"). The server extracts the calendar date in the given timeZone and queries from 00:00:00 to 23:59:59.999999 of that day.

​
Response

An array of transfer objects in the same shape returned by GET /last_money_transfers/<limit>. An empty array is returned if there are no transfers on the specified day.
​
id
integer
The unique identifier of the transfer.
​
description
string
Human-readable description of the transfer.
​
amount
float
Transfer amount. Negative for expenses, positive for income.
​
created_at
string
ISO 8601 timestamp (UTC) when the transfer was created.
​
modifed_at
string
ISO 8601 timestamp (UTC) of the last modification. Field name is modifed_at (single i) matching the database column.
​
tags
array
Category/tag objects for this transfer.
​
created_by
string
username of the user who created the transfer.

​
Example Request

curl -X POST https://your-app.example.com/money_transfer_from_date \
  -H "Content-Type: application/json" \
  -H "Cookie: session=<your-session-cookie>" \
  -d '{
    "timeZone": "America/New_York",
    "date": "2024-01-15T00:00:00Z"
  }'

​
Example Request Body

{
  "timeZone": "America/New_York",
  "date": "2024-01-15T00:00:00Z"
}

​
Example Response

[
  {
    "id": 42,
    "description": "Groceries",
    "amount": -35.50,
    "created_at": "2024-01-15T10:30:00",
    "modifed_at": "2024-01-15T10:30:00",
    "tags": [
      {"id": 3, "name": "food"}
    ],
    "created_by": "Jane Smith"
  }
]

​
Error Cases

StatusCondition
302 FoundThe user is not authenticated.
400 Bad RequestThe request body is missing date or timeZone, or date cannot be parsed as ISO 8601.
500 Internal Server ErrortimeZone is not a valid IANA timezone identifier and pytz raises an exception.

Build docs developers (and LLMs) love

Get started for freeTalk to us