---
title: "List Subjects for a Registration"
method: GET
path: "/providers/registrations/{provider_id}/subjects/"
tags: ["Registration Providers"]
---

# List Subjects for a Registration

`GET /providers/registrations/{provider_id}/subjects/`

Retrieve a list of subjects (taxonomy terms) assigned to a specific registration.
Subjects are used to categorize the content of a registration according to a predefined taxonomy. Each subject may be a part of a hierarchical structure, allowing for detailed categorization.
#### Permissions - Public registrations: No authentication required. - Private registrations: Only contributors with read access can view subjects.
#### Returns - A JSON object with a `data` key containing an array of subjects. - Each subject includes metadata such as the subject text and its hierarchical position.

## Path parameters

- `provider_id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Successful retrieval of subjects for the registration.

## Other responses

- `401` — Unauthorized. Authentication is required to access this registration's subjects.
- `403` — Forbidden. You do not have permission to access 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/revisions/3c5164c707eb/schema)