---
title: "Retrieve Subjects Relationship for a Registration"
method: GET
path: "/registrations/{registration_id}/relationships/subjects/"
tags: ["Registrations"]
---

# Retrieve Subjects Relationship for a Registration

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

Retrieve the relationship data for the subjects associated with a specific registration.
This endpoint returns an array of subject identifiers in a `relationships` object, without the full subject resource details.   To get the full details of the subjects, you should follow the `related` link provided in the relationships object or query the `/registrations/{registration_id}/subjects/` endpoint.
#### Permissions
 - Public registrations expose this relationship publicly.
 - Private registrations require appropriate permissions to view their subjects.

#### Returns
 - A JSON object with a `data` key, which contains an array of `subject` resource identifier objects (`id` and `type`).

## Path parameters

- `registration_id` string, required

## Response `200`

Successfully retrieved the subject relationship data for this registration.

## Other responses

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