List Subjects — GET /subjects Endpoint Reference Guide

Use GET /v1/subjects to retrieve all your subject profiles. Each subject includes its type, color, weekly time slots, and the syllabus associated with it.

Endpoint

GET https://api.taketime.app/v1/subjects

Query Parameters

string

Filter subjects by type. Accepted values: study, training, inactive. Omit this parameter to return all subjects regardless of type.

Response

Returns an array of subject objects inside the data field.

string

Unique identifier for the subject.

string

Display name of the subject.

string

The subject type. One of study, training, or inactive.

string

Hex color code used to represent this subject in the app (e.g. #6366f1).

array

Array of weekly time slot objects. Each slot defines the days of the week and time range when this subject is scheduled.

Show Slot object fields

array of integers

Days of the week on which this slot is active. Uses the same day numbering as the API spec (e.g. [1, 3, 5]).

string

Slot start time in HH:MM format.

string

Slot end time in HH:MM format.

array

An array of syllabus topic objects for this subject. Each object contains title (string), duration (integer, minutes), and done (boolean).

Example response

{
  "data": [
    {
      "id": "sub_xyz",
      "name": "JavaScript",
      "type": "study",
      "color": "#6366f1",
      "slots": [
        {
          "days": [1, 3, 5],
          "start": "09:00",
          "end": "10:00"
        }
      ],
      "syllabus": [
        { "title": "Arrays", "duration": 30, "done": false }
      ]
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-06-11T09:00:00Z"
  }
}

Examples

# List all study subjects
curl "https://api.taketime.app/v1/subjects?type=study" \
  -H "Authorization: Bearer tt_live_your_key_here"

const response = await fetch(
  'https://api.taketime.app/v1/subjects?type=study',
  {
    headers: {
      'Authorization': 'Bearer tt_live_your_key_here',
    },
  }
);

const { data, error } = await response.json();

if (error) {
  console.error('Error:', error.code, error.message);
} else {
  console.log(`Found ${data.length} study subjects`);
}

Omit the type query parameter to retrieve all subjects across all types in a single request.

Overview

Blocks

Subjects

Stats & Schedule

List Subjects — GET /subjects Endpoint Reference Guide

Endpoint

Query Parameters

Response

Examples

​Endpoint

​Query Parameters

​Response

​Examples

Endpoint

Query Parameters

Response

Examples