OSF

OSF Licenses API

The Licenses API from OSF — 2 operation(s) for licenses.

Operations 2

GET /licenses/ List all licenses #
GET /license/{license_id}/ Retrieve a license #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/osf:osf-licenses-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

osf-licenses-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OSF APIv2 Documentation Licenses API
  description: This is the official documentation for the OSF (Open Science Framework) API v2.
  version: '2.0'
  termsOfService: https://osf.io/terms_of_use/
  contact:
    name: OSF Support Team
    email: support@osf.io
    url: https://help.osf.io/
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  x-logo:
    url: https://cdn.cos.io/media/images/cos_center_logo_small.original.png
    backgroundColor: transparent
servers:
- url: https://api.test.osf.io/v2
tags:
- name: Licenses
paths:
  /licenses/:
    get:
      summary: List all licenses
      description: 'A paginated list of licenses. The returned licenses are sorted by their name.

        #### Returns

        Returns a JSON object containing `data` and `links` keys.

        The `data` key contains an array of 10 licenses. Each resource in the array is a separate license object and contains the full representation of the license, meaning additional requests to a license''s detail view are not necessary.


        The `links` key contains a dictionary of links that can be used for pagination.


        This request should never return an error.

        #### Filtering

        You can optionally request that the response only include licenses that match your filters by utilizing the `filter` query parameter, e.g. [https://api.osf.io/v2/licenses/?filter[name]=apache](https://api.osf.io/v2/licenses/?filter[name]=apache).


        Licenses may be filtered by their `id`, and `name`.'
      tags:
      - Licenses
      operationId: license_list
      x-response-schema: License
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  title: License
                  properties:
                    id:
                      type: string
                      readOnly: true
                      description: The identifier of the license.
                    type:
                      type: string
                      readOnly: true
                      description: The type identifier of the license (`license`).
                    attributes:
                      type: object
                      title: Attributes
                      readOnly: true
                      description: The properties of the license.
                      properties:
                        name:
                          type: string
                          readOnly: true
                          description: Name of the license.
                        text:
                          type: string
                          readOnly: true
                          description: Full text of the license.
                        required_fields:
                          type: array
                          readOnly: true
                          description: Fields required for this license (provided to help front-end validators). Maps to properties on the NodeLicense model.
                          items:
                            type: string
                            readOnly: true
                            description: Individual fields required by this license.
                    links:
                      type: object
                      title: Links
                      readOnly: true
                      description: URLs to alternative representations of the license.
                      properties:
                        self:
                          type: string
                          format: URL
                          readOnly: true
                          description: A link to the detail page for the license.
              example:
                data:
                - links:
                    self: https://api.osf.io/v2/licenses/563c1cf88c5e4a3877f9e968/
                  attributes:
                    text: 'Copyright (c) {{year}}, {{copyrightHolders}}

                      All rights reserved.


                      The full descriptive text of the License.

                      '
                    required_fields:
                    - year
                    - copyrightHolders
                    name: BSD 2-Clause "Simplified" License
                  type: licenses
                  id: 563c1cf88c5e4a3877f9e968
                links:
                  first: ''
                  last: https://api.osf.io/v2/licenses/?page=2
                  prev: ''
                  next: https://api.osf.io/v2/licenses/?page=2
                  meta:
                    total: 16
                    per_page: 10
  /license/{license_id}/:
    get:
      summary: Retrieve a license
      description: 'Retrieves the details of a license.

        #### Returns

        Returns a JSON object with a `data` key containing the representation of the requested license, if the request is successful.


        If the request is unsuccessful, an `errors` key containing information about the failure will be returned. Refer to the list of error codes to understand why this request may have failed.'
      parameters:
      - in: path
        required: true
        name: license_id
        description: The unique identifier of the license.
        schema:
          type: string
      tags:
      - Licenses
      operationId: licenses_read
      x-response-schema: License
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                title: License
                properties:
                  id:
                    type: string
                    readOnly: true
                    description: The identifier of the license.
                  type:
                    type: string
                    readOnly: true
                    description: The type identifier of the license (`license`).
                  attributes:
                    type: object
                    title: Attributes
                    readOnly: true
                    description: The properties of the license.
                    properties:
                      name:
                        type: string
                        readOnly: true
                        description: Name of the license.
                      text:
                        type: string
                        readOnly: true
                        description: Full text of the license.
                      required_fields:
                        type: array
                        readOnly: true
                        description: Fields required for this license (provided to help front-end validators). Maps to properties on the NodeLicense model.
                        items:
                          type: string
                          readOnly: true
                          description: Individual fields required by this license.
                  links:
                    type: object
                    title: Links
                    readOnly: true
                    description: URLs to alternative representations of the license.
                    properties:
                      self:
                        type: string
                        format: URL
                        readOnly: true
                        description: A link to the detail page for the license.
              example:
                data:
                  links:
                    self: https://api.osf.io/v2/licenses/563c1cf88c5e4a3877f9e968/
                  attributes:
                    text: 'Copyright (c) {{year}}, {{copyrightHolders}}

                      All rights reserved.


                      The full descriptive text of the License

                      '
                    required_fields:
                    - year
                    - copyrightHolders
                    name: BSD 2-Clause "Simplified" License
                  type: licenses
                  id: 563c1cf88c5e4a3877f9e968
x-tagGroups:
- name: Welcome
  tags:
  - Introduction
  - General Usage
  - Authentication
  - Pagination
  - Versioning
  - Filtering
  - Sparse Fieldsets
  - Embedding
  - Request Formatting
  - Errors & Error Codes
  - Entities & Entity Collections
- name: API Reference
  tags:
  - Actions
  - Addons
  - Applications
  - Base
  - CEDAR Metadata
  - Citations
  - Comments
  - Collections
  - Collection Submissions
  - Collection Submissions Actions
  - Collection Providers
  - Custom Metadata
  - Files
  - Licenses
  - Logs
  - Institutions
  - Identifiers
  - Registration Schemas
  - Registration Schema Blocks
  - Schema Responses
  - Schema Response Actions
  - Nodes
  - Notification Subscriptions
  - Preprints
  - Preprint Providers
  - Draft Registrations
  - Registrations
  - Registration Providers
  - Regions
  - OAuth Scopes
  - Taxonomies
  - Tokens
  - Users
  - View Only Links
  - Wikis
  - Subjects
  - GUIDs
  - Requests
  - Resources