Skip to main content
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

​
type
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.
​
id
string
Unique identifier for the subject.
​
name
string
Display name of the subject.
​
type
string
The subject type. One of study, training, or inactive.
​
color
string
Hex color code used to represent this subject in the app (e.g. #6366f1).
​
slots
array
Array of weekly time slot objects. Each slot defines the days of the week and time range when this subject is scheduled.
​
syllabus
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"
Omit the type query parameter to retrieve all subjects across all types in a single request.