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

# List Registration Schemas for a Provider

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

## Request

- Base URL: `https://api.test.osf.io/v2`
- URL: `https://api.test.osf.io/v2/providers/registrations/{provider_id}/schemas/`
- Auth: none declared

Retrieve a list of registration schemas available for a specific registration provider.
Registration schemas define the structure and fields that users must complete when registering a project with the provider.
#### Permissions - No authentication required for public providers. - Private providers may require authentication.
#### Returns - A JSON object with a `data` array containing the registration schemas.

## Path parameters

- `provider_id` string, required

## Query parameters

- `filter[active]` boolean
- `page` integer
- `per_page` integer

## Response `200`

Successful retrieval of registration schemas for the provider.

- object
  - `data` object[]
    - `id` string: The unique identifier of the Registration Schema.
    - `type` string: The type identifier of the Registration Schema (`registration-schemas`).
    - `attributes` object: The attributes of the Registration Schema.
      - `name` string: The name of the Registration Schema
      - `active` boolean: Bool that represents whether the Registration Schema is active.
      - `schema_version` integer: The version of this Registration Schema
      - `schema` object: This dictionary is the raw schema that originally defined the Registration Schema object and it's blocks.
    - `links` object: URLs that link to alternative representations of the Registration Schema.
      - `self` string, URL: A link to the detail page for a Registration Schema.
    - `relationships` object: Links to other entities or entity collections that have a relationship to the Registration Schema.
      - `schema_blocks` string, URL: A link to the list of schema blocks that contain the question prompt information for the Registration Schema.
  - `links` object
    - `self` string
    - `next` string
    - `prev` string
  - `meta` object
    - `total` integer
    - `per_page` integer
    - `version` string

## Other responses

- `400`: Bad request. Invalid parameters or input.
- `404`: Not found. Registration provider does not exist.

---

[API](https://skmtc.dev/osf/apis/osf-apiv2-documentation.md) - [All operations](https://skmtc.dev/osf/apis/osf-apiv2-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/osf/apis/osf-apiv2-documentation/revisions/3c5164c707eb?raw)