Get Your Full Weekly Study Schedule — Take Time API

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

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:

string

ISO 8601 date string for the Monday that opens the requested week, e.g. "2026-06-08".

string

ISO 8601 date string for the Sunday that closes the requested week, e.g. "2026-06-14".

array

An array of seven day objects, one per day of the week. Each day object contains:

string

The calendar date for this day in YYYY-MM-DD format.

string

The full day name, e.g. "Monday".

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.

Overview

Blocks

Subjects

Stats & Schedule

Get Your Full Weekly Study Schedule — Take Time API

Endpoint

Query Parameters

Response Fields

Example Response

Code Example

​Endpoint

​Query Parameters

​Response Fields

​Example Response

​Code Example

Endpoint

Query Parameters

Response Fields

Example Response

Code Example