---
title: "Get study description by study id or alias"
method: GET
path: "/study/{id}"
tags: ["study"]
---

# Get study description by study id or alias

`GET /study/{id}`

Returns information about the study with the given id or alias.

## Path parameters

- `id` string, required

## Query parameters

- `api_key` string

## Response `200`

A study description

- Study
  - `study` StudyStudy
    - `id` string — The ID of the study
    - `alias` string — The alias of the study
    - `main_entity_type` string — The type of entity collected in the study (e.g. task or run)
    - `name` string — The name of the study
    - `creation_date` string — The datetime that the dataset was uploaded, format yyyy-MM-dd HH:mm:ss
    - `creator` string — A comma-separated list of the study creators
    - `tag` StudyStudyTag
      - `name` string — The name of the study (e.g. study_1)
      - `write_access` string — The write access level of the study (e.g. public)
    - `data` StudyStudyData — The IDs of the datasets that are directly or indirectly linked to the study (e.g. because it is part of a task that belongs to the study)
      - `data_id` string[]
    - `tasks` StudyStudyTasks — The IDs of the tasks that are directly or indirectly linked to the study (e.g. because it is part of a run that belongs to the study)
      - `task_id` string[]
    - `flows` StudyStudyFlows — The IDs of the flows that are directly or indirectly linked to the study (e.g. because it is part of a run that belongs to the study)
      - `flow_id` string[]
    - `runs` StudyStudyRuns — The IDs of the runs attached to this study
      - `run_id` string[]

## Other responses

- `412` — Precondition failed. An error code and message are returned. 601 - Unknown study. The study with the given id or alias was not found in the database

---

[API](https://skmtc.net/openml/apis/openml-api.md) · [All operations](https://skmtc.net/openml/apis/openml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openml/openml-api/revisions/263d3d6ee586/schema)