Speakeasy Logo
Skip to Content
OpenAPI HubInfo

Info Object in OpenAPI

The document’s info object contains information about the document, including fields like title, version, and description that help to identify the purpose and owner of the document.

Example:

Field
Type
String
Required
✅
Description
A name for the API contained within the document.
Type
String
Required
✅
Description
The version of this OpenAPI document, not the version of the API or the OpenAPI Specification used. This is recommended to be a Semantic Version .
Type
String
Required
Description
(Available in OpenAPI 3.1.x ONLY)A short sentence summarizing the API contained with the document.
Type
String
Required
Description
A longer description of the API contained within the document. This may contain CommonMark syntax  to provide a rich description.
Required
Description
Contact information for the maintainer of the API. Note: Currently not supported by Speakeasy tooling.
Required
Description
The license the API is made available under.
Type
String
Required
Description
A URL to the terms of service for the API.
Required
Description
Any number of extension fields can be added to the info object that can be used by tooling and vendors to add additional metadata and functionality to the OpenAPI Specification.

The above order of fields is recommended (but is not required by the OpenAPI specification) as it puts the most important information first and allows the reader to get a quick overview of the document and API.

Contact Object in OpenAPI

Contact information for the maintainer of the API.

Field
Type
String
Required
Description
The name of a contact that could be approached, for example, for support.
Type
String
Required
Description
A URL to a website or similar providing contact information.
Type
String
Required
Description
An email address for the contact.
Required
Description
Any number of extension fields can be added to the contact object that can be used by tooling and vendors.

License Object in OpenAPI

The license the API is made available under.

Field
Type
String
Required
✅
Description
The name of the license.
Type
String
Required
Description
(Available in OpenAPI 3.1.x ONLY)An SPDX identifier  for the license. Provided only if
isn't set.
Type
String
Required
Description
A URL to the license information. Provided only if
isn't set.
Required
Description
Any number of extension fields can be added to the license object that can be used by tooling and vendors.

Last updated on