# OSF Institutions API

**Canonical:** https://apis.io/apis/osf/osf-institutions-api/  
**Provider:** OSF — https://apis.io/providers/osf/  
**Base URL:** https://api.osf.io  
**Documentation:** https://developer.osf.io

OSF Institutions API is one of 41 APIs that [OSF](https://apis.io/providers/osf/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Institutions. The published artifact set on APIs.io includes an OpenAPI specification.

The Institutions API from OSF — 8 operation(s) for institutions.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/institutions/` | List all institutions |
| GET | `/institutions/{institution_id}/` | Retrieve an institution |
| GET | `/institutions/{institution_id}/users/` | List all affiliated users |
| GET | `/institutions/{institution_id}/nodes/` | List all affiliated nodes |
| GET | `/institutions/{institution_id}/registrations/` | List all affiliated registrations |
| GET | `/institutions/{institution_id}/relationships/nodes/` | List nodes affiliated with an institution (relationship data) |
| POST | `/institutions/{institution_id}/relationships/nodes/` | Add node relationships to an institution |
| DELETE | `/institutions/{institution_id}/relationships/nodes/` | Remove node relationships from an institution |
| GET | `/institutions/{institution_id}/relationships/registrations/` | List registrations affiliated with an institution (relationship data) |
| POST | `/institutions/{institution_id}/relationships/registrations/` | Add registration relationships to an institution |
| DELETE | `/institutions/{institution_id}/relationships/registrations/` | Remove registration relationships from an institution |
| GET | `/draft_registrations/{draft_id}/relationships/institutions/` | Retrieve affiliated institutions for a draft registration |
| POST | `/draft_registrations/{draft_id}/relationships/institutions/` | Add affiliated institutions to a draft registration |
| DELETE | `/draft_registrations/{draft_id}/relationships/institutions/` | Remove affiliated institutions from a draft registration |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/osf/openapi/osf-institutions-api-openapi.yml

## Other OSF APIs (12)

- [OSF API](https://apis.io/apis/osf/osf-api/)
- [OSF Actions API](https://apis.io/apis/osf/osf-actions-api/)
- [OSF Applications API](https://apis.io/apis/osf/osf-applications-api/)
- [OSF Base API](https://apis.io/apis/osf/osf-base-api/)
- [OSF CEDAR Metadata API](https://apis.io/apis/osf/osf-cedar-metadata-api/)
- [OSF Citations API](https://apis.io/apis/osf/osf-citations-api/)
- [OSF Collection Providers API](https://apis.io/apis/osf/osf-collection-providers-api/)
- [OSF Collection Submission Actions API](https://apis.io/apis/osf/osf-collection-submission-actions-api/)
- [OSF Collection Submissions API](https://apis.io/apis/osf/osf-collection-submissions-api/)
- [OSF Collections API](https://apis.io/apis/osf/osf-collections-api/)
- [OSF Comments API](https://apis.io/apis/osf/osf-comments-api/)
- [OSF Contributors API](https://apis.io/apis/osf/osf-contributors-api/)

## Tags

Institutions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/osf/osf-institutions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/osf/.