Skip to main content
Use GET /v1/schedule to retrieve your complete weekly schedule. The response includes all configured time slots for each subject, organized by day, along with any blocks that have been generated for the requested week.

​
Endpoint

GET /v1/schedule

​
Query Parameters

​
week_offset
number
default:"0"
The week to retrieve, relative to the current week. Use 0 for the current week, -1 for last week, and 1 for next week. You can pass any positive or negative integer to navigate further forward or backward.

​
Response Fields

The response returns a weekly schedule object with the following shape:
​
week_start
string
ISO 8601 date string for the Monday that opens the requested week, e.g. "2026-06-08".
​
week_end
string
ISO 8601 date string for the Sunday that closes the requested week, e.g. "2026-06-14".
​
days
array
An array of seven day objects, one per day of the week. Each day object contains:
​
date
string
The calendar date for this day in YYYY-MM-DD format.
​
label
string
The full day name, e.g. "Monday".
​
blocks
array
An array of block objects scheduled for this day. Each block includes id, subject_id, start, end, topic, and done.

​
Example Response

{
  "data": {
    "week_start": "2026-06-08",
    "week_end": "2026-06-14",
    "days": [
      {
        "date": "2026-06-08",
        "label": "Monday",
        "blocks": [
          {
            "id": "blk_001",
            "subject_id": "sub_math",
            "start": "09:00",
            "end": "10:00",
            "topic": "Linear algebra review",
            "done": true
          }
        ]
      },
      {
        "date": "2026-06-09",
        "label": "Tuesday",
        "blocks": []
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_def456",
    "timestamp": "2026-06-11T09:00:00Z"
  }
}

​
Code Example

cURL
curl "https://api.taketime.app/v1/schedule?week_offset=0" \
  -H "Authorization: Bearer tt_live_your_key_here"
Pass week_offset=1 to preview the auto-generated schedule for next week before it begins. This is useful for reviewing what Take Time has planned and making adjustments in advance.