API Simulator OpenAPI Files
Download an OpenAPI JSON file to use in your REST Client.
File Download Links
OpenAPI JSON files are available in the default format and in specific OpenAPI versions. The default openapi.json endpoint currently returns OpenAPI v 3.1.
- OpenAPI v 3.0 JSON standard validation download - less validation download
- OpenAPI v 3.1 JSON standard validation download - less validation download
- OpenAPI v 3.2 JSON standard validation download - less validation download
Open OpenAPI 3.2 In Online UIs
Tool support for OpenAPI 3.2 is still emerging, so these links help compare how each UI handles the same file.
Standard validation
Open the user-facing API Simulator OpenAPI 3.2 file.
Open in Swagger Open in OpenAPI Explorer Open in Scalar Open in Stoplight Elements Open in Zudoku Open in Redoc
Less validation
Open the more permissive API Simulator OpenAPI 3.2 file for testing edge cases.
Open in Swagger Open in OpenAPI Explorer Open in Scalar Open in Stoplight Elements Open in Zudoku Open in Redoc
Normal OpenAPI File Explained
The Normal OpenAPI File is intended for use as though you were a user.
It only lists endpoints that are valid to use, and has additional validation on the URL Parameters that you can enter.
When this type of file is loaded into a Swagger UI Generation application it makes it easy to USE the API but makes it harder to TEST the API.
Permissive OpenAPI File Explained
The Permissive OpenAPI File is intended for testing.
It lists all the end points with more Verbs i.e. even verbs that the API defines as not available.
The parameters are also possible to send as empty and type validation is not performed on the parameter values. This makes it possible to use Swagger UI applications to test more extreme situations.