---
title: "List Registration Subjects"
method: GET
path: "/registrations/{registration_id}/subjects/"
tags: ["Registrations"]
---

# List Registration Subjects

`GET /registrations/{registration_id}/subjects/`

Retrieve a list of taxonomy subjects assigned to a specific registration.
Subjects represent the topics, disciplines, or areas of research that the registration is categorized under. These subjects help with search, discovery, and classification within the OSF platform.
#### Permissions
 - Publicly accessible if the registration is public.
 - Private registrations require admin permissions to access.

#### Returns
 - A JSON object with a `data` key containing an array of subject resources.
 - Each subject describes a taxonomy term, including its name and hierarchical position.

## Path parameters

- `registration_id` string, required

## Query parameters

- `page` integer
- `filter[text]` string

## Response `200`

Successfully retrieved list of subjects for this registration.

## Other responses

- `401` — Unauthorized. Authentication is required to access subjects for a private registration.
- `403` — Forbidden. You do not have permission to view subjects for this registration.
- `404` — Not Found. No registration matches the given ID.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/versions/ca701048eb0d/schema)