info-license-strict

October 16, 2025 · View on GitHub

Requires either the license URL or identifier in your API descriptions.

OASCompatibility
2.0✅
3.0✅
3.1✅
3.2✅
flowchart TD

Root ==> Info --> License --> url
                  License --> identifier

style url fill:#codaf9,stroke:#0044d4,stroke-width:5px
style identifier fill:#codaf9,stroke:#0044d4,stroke-width:5px

API design principles

The principle of providing your users with accurate and relevant information does not apply to API design only, but to any product-related communication in general.

Before they can work with your API, your users must understand the terms and conditions of your API usage.

By being upfront with the API license, you can reduce friction and encourage API adoption.

Configuration

OptionTypeDescription
severitystringPossible values: off, warn, error. Default warn (in recommended configuration).

An example configuration:

rules:
  info-license-strict: error

Examples

Given the following configuration:

rules:
  info-license-strict: error

Example of an incorrect license:

info:
  license:
    name: MIT

Example of a correct license with URL:

info:
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html

Example of a correct license with identifier:

info:
  license:
    name: Apache 2.0
    identifier: Apache-2.0

Resources