Type object
File match swagger.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/swagger-api-2-0/latest.json
Source https://spec.openapis.org/oas/2.0/schema/2017-08-27

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

swagger string required

The Swagger version of this document.

Values: "2.0"
info object required

General information about the API.

6 nested properties
title string required

A unique and precise title of the API.

version string required

A semantic version number of the API.

description string

A longer description of the API. Should be different from the title. GitHub Flavored Markdown is allowed.

termsOfService string

The terms of service for the API.

contact object

Contact information for the owners of the API.

3 nested properties
name string

The identifying name of the contact person/organization.

url string

The URL pointing to the contact information.

format=uri
email string

The email address of the contact person/organization.

format=email
license object
2 nested properties
name string required

The name of the license type. It's encouraged to use an OSI compatible license.

url string

The URL pointing to the license.

format=uri
paths object required

Relative paths to the individual endpoints. They must be relative to the 'basePath'.

host string

The host (name or ip) of the API. Example: 'swagger.io'

pattern=^[^{}/ :\\]+(?::\d+)?$
basePath string

The base path to the API. Example: '/api'.

pattern=^/
schemes string[]

The transfer protocol of the API.

uniqueItems=true
consumes

A list of MIME types accepted by the API.

All of: mediaTypeList mimeType[]
produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
definitions Record<string, object>

One or more JSON objects describing the schemas being consumed and produced by the API.

parameters Record<string, bodyParameter | nonBodyParameter>

One or more JSON representations for parameters

responses Record<string, object>

One or more JSON representations for responses

uniqueItems=true
securityDefinitions Record<string, basicAuthenticationSecurity | apiKeySecurity | oauth2ImplicitSecurity | oauth2PasswordSecurity | oauth2ApplicationSecurity | oauth2AccessCodeSecurity>
tags tag[]
uniqueItems=true
externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string

Definitions

info object

General information about the API.

title string required

A unique and precise title of the API.

version string required

A semantic version number of the API.

description string

A longer description of the API. Should be different from the title. GitHub Flavored Markdown is allowed.

termsOfService string

The terms of service for the API.

contact object

Contact information for the owners of the API.

3 nested properties
name string

The identifying name of the contact person/organization.

url string

The URL pointing to the contact information.

format=uri
email string

The email address of the contact person/organization.

format=email
license object
2 nested properties
name string required

The name of the license type. It's encouraged to use an OSI compatible license.

url string

The URL pointing to the license.

format=uri
contact object

Contact information for the owners of the API.

name string

The identifying name of the contact person/organization.

url string

The URL pointing to the contact information.

format=uri
email string

The email address of the contact person/organization.

format=email
license object
name string required

The name of the license type. It's encouraged to use an OSI compatible license.

url string

The URL pointing to the license.

format=uri
paths object

Relative paths to the individual endpoints. They must be relative to the 'basePath'.

definitions Record<string, object>

One or more JSON objects describing the schemas being consumed and produced by the API.

parameterDefinitions Record<string, bodyParameter | nonBodyParameter>

One or more JSON representations for parameters

responseDefinitions Record<string, object>

One or more JSON representations for responses

externalDocs object

information about external documentation

url string required
format=uri
description string
examples object
mimeType string

The MIME type of the HTTP message.

operation object
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
pathItem object
$ref string
get object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
put object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
post object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
delete object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
options object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
head object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true
patch object
12 nested properties
responses object required

Response objects names can either be any valid HTTP status code or 'default'.

tags string[]
uniqueItems=true
summary string

A brief summary of the operation.

description string

A longer description of the operation, GitHub Flavored Markdown is allowed.

externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
operationId string

A unique identifier of the operation.

produces

A list of MIME types the API can produce.

All of: mediaTypeList mimeType[]
consumes

A list of MIME types the API can consume.

All of: mediaTypeList mimeType[]

The parameters needed to send a valid API call.

uniqueItems=true
schemes string[]

The transfer protocol of the API.

uniqueItems=true
deprecated boolean
Default: false
uniqueItems=true

The parameters needed to send a valid API call.

uniqueItems=true
responses object

Response objects names can either be any valid HTTP status code or 'default'.

responseValue response | jsonReference
response object
description string required
schema schema | fileSchema
headers Record<string, object>
examples object
headers Record<string, object>
header object
type string required
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
description string
vendorExtension

Any property starting with x- is valid.

bodyParameter object
name string required

The name of the parameter.

in string required

Determines the location of the parameter.

Values: "body"
schema object required

A deterministic version of a JSON Schema object.

30 nested properties
$ref string
format string
title title
description description
default default
multipleOf multipleOf
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
maxProperties positiveInteger
minProperties positiveIntegerDefault0
required stringArray
enum enum
additionalProperties schema | boolean
Default:
{}
type type
items schema | schema[]
Default:
{}
allOf schema[]
minItems=1
properties Record<string, object>
Default:
{}
discriminator string
readOnly boolean
Default: false
xml object
5 nested properties
name string
namespace string
prefix string
attribute boolean
Default: false
wrapped boolean
Default: false
externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
example
description string

A brief description of the parameter. This could contain examples of use. GitHub Flavored Markdown is allowed.

required boolean

Determines whether or not this parameter is required or optional.

Default: false
headerParameterSubSchema object
required boolean

Determines whether or not this parameter is required or optional.

Default: false
in string

Determines the location of the parameter.

Values: "header"
description string

A brief description of the parameter. This could contain examples of use. GitHub Flavored Markdown is allowed.

name string

The name of the parameter.

type string
Values: "string" "number" "boolean" "integer" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
queryParameterSubSchema object
required boolean

Determines whether or not this parameter is required or optional.

Default: false
in string

Determines the location of the parameter.

Values: "query"
description string

A brief description of the parameter. This could contain examples of use. GitHub Flavored Markdown is allowed.

name string

The name of the parameter.

allowEmptyValue boolean

allows sending a parameter by name only or with an empty value.

Default: false
type string
Values: "string" "number" "boolean" "integer" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes" "multi"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
formDataParameterSubSchema object
required boolean

Determines whether or not this parameter is required or optional.

Default: false
in string

Determines the location of the parameter.

Values: "formData"
description string

A brief description of the parameter. This could contain examples of use. GitHub Flavored Markdown is allowed.

name string

The name of the parameter.

allowEmptyValue boolean

allows sending a parameter by name only or with an empty value.

Default: false
type string
Values: "string" "number" "boolean" "integer" "array" "file"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes" "multi"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
pathParameterSubSchema object
required boolean required

Determines whether or not this parameter is required or optional.

Values: true
in string

Determines the location of the parameter.

Values: "path"
description string

A brief description of the parameter. This could contain examples of use. GitHub Flavored Markdown is allowed.

name string

The name of the parameter.

type string
Values: "string" "number" "boolean" "integer" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
nonBodyParameter object
parameter bodyParameter | nonBodyParameter
schema object

A deterministic version of a JSON Schema object.

$ref string
format string
title title
description description
default default
multipleOf multipleOf
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
maxProperties positiveInteger
minProperties positiveIntegerDefault0
required stringArray
enum enum
additionalProperties schema | boolean
Default:
{}
type type
items schema | schema[]
Default:
{}
allOf schema[]
minItems=1
properties Record<string, object>
Default:
{}
discriminator string
readOnly boolean
Default: false
xml object
5 nested properties
name string
namespace string
prefix string
attribute boolean
Default: false
wrapped boolean
Default: false
externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
example
fileSchema object

A deterministic version of a JSON Schema object.

type string required
Values: "file"
format string
title title
description description
default default
required stringArray
readOnly boolean
Default: false
externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
example
primitivesItems object
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
17 nested properties
type string
Values: "string" "number" "integer" "boolean" "array"
format string
items object
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
collectionFormat string
Default: "csv"
Values: "csv" "ssv" "tsv" "pipes"
default default
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
pattern pattern
maxItems positiveInteger
uniqueItems uniqueItems
enum enum
multipleOf multipleOf
security securityRequirement[]
securityRequirement Record<string, string[]>
xml object
name string
namespace string
prefix string
attribute boolean
Default: false
wrapped boolean
Default: false
tag object
name string required
description string
externalDocs object

information about external documentation

2 nested properties
url string required
format=uri
description string
securityDefinitions Record<string, basicAuthenticationSecurity | apiKeySecurity | oauth2ImplicitSecurity | oauth2PasswordSecurity | oauth2ApplicationSecurity | oauth2AccessCodeSecurity>
basicAuthenticationSecurity object
type string required
Values: "basic"
description string
apiKeySecurity object
type string required
Values: "apiKey"
name string required
in string required
Values: "header" "query"
description string
oauth2ImplicitSecurity object
type string required
Values: "oauth2"
flow string required
Values: "implicit"
authorizationUrl string required
format=uri
scopes Record<string, string>
description string
oauth2PasswordSecurity object
type string required
Values: "oauth2"
flow string required
Values: "password"
tokenUrl string required
format=uri
scopes Record<string, string>
description string
oauth2ApplicationSecurity object
type string required
Values: "oauth2"
flow string required
Values: "application"
tokenUrl string required
format=uri
scopes Record<string, string>
description string
oauth2AccessCodeSecurity object
type string required
Values: "oauth2"
flow string required
Values: "accessCode"
authorizationUrl string required
format=uri
tokenUrl string required
format=uri
scopes Record<string, string>
description string
oauth2Scopes Record<string, string>
mediaTypeList mimeType[]
parametersList parameter | jsonReference[]

The parameters needed to send a valid API call.

schemesList string[]

The transfer protocol of the API.

collectionFormat string
collectionFormatWithMulti string
title title
description description
default default
multipleOf multipleOf
maximum maximum
exclusiveMaximum exclusiveMaximum
minimum minimum
exclusiveMinimum exclusiveMinimum
maxLength positiveInteger
minLength positiveIntegerDefault0
pattern pattern
maxItems positiveInteger
minItems positiveIntegerDefault0
uniqueItems uniqueItems
enum enum
jsonReference object
$ref string required