> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taketime.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Your Full Weekly Study Schedule — Take Time API

> GET /v1/schedule — fetch your full weekly schedule with all study blocks organized by day, with support for past and future weeks via week offset.

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

```http theme={null}
GET /v1/schedule
```

## Query Parameters

<ParamField query="week_offset" type="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.
</ParamField>

## Response Fields

The response returns a weekly schedule object with the following shape:

<ResponseField name="week_start" type="string">
  ISO 8601 date string for the Monday that opens the requested week, e.g. `"2026-06-08"`.
</ResponseField>

<ResponseField name="week_end" type="string">
  ISO 8601 date string for the Sunday that closes the requested week, e.g. `"2026-06-14"`.
</ResponseField>

<ResponseField name="days" type="array">
  An array of seven day objects, one per day of the week. Each day object contains:

  <ResponseField name="date" type="string">
    The calendar date for this day in `YYYY-MM-DD` format.
  </ResponseField>

  <ResponseField name="label" type="string">
    The full day name, e.g. `"Monday"`.
  </ResponseField>

  <ResponseField name="blocks" type="array">
    An array of block objects scheduled for this day. Each block includes `id`, `subject_id`, `start`, `end`, `topic`, and `done`.
  </ResponseField>
</ResponseField>

## Example Response

```json theme={null}
{
  "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

```bash cURL theme={null}
curl "https://api.taketime.app/v1/schedule?week_offset=0" \
  -H "Authorization: Bearer tt_live_your_key_here"
```

<Note>
  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.
</Note>