The clients API from Swagger Codegen — 9 operation(s) for clients.
0 of 11 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 1 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/swagger-codegen:swagger-codegen-clients-api"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.
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: 3.2.0
info:
title: Swagger Codegen Clients API
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
version: '1.0'
description: 'Operations tagged clients across 2 of this provider''s published API definitions: swagger-generator-v2-swagger-original.json, swagger-generator-v3-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://generator.swagger.io/api
- url: /api
tags:
- name: Clients
paths:
/gen/download/{fileId}:
get:
tags:
- Clients
summary: Downloads a pre-generated file
description: A valid `fileId` is generated by the `/clients/{language}` or `/servers/{language}` POST operations. The fileId code can be used just once, after which a new `fileId` will need to be requested.
operationId: downloadFile
parameters:
- name: fileId
in: path
required: true
schema:
type: string
responses:
'200':
description: successful operation
content:
application/octet-stream:
schema:
type: string
servers:
- url: https://generator.swagger.io/api
/gen/clients/{language}:
get:
tags:
- Clients
summary: Returns options for a client library
description: ''
operationId: getClientOptions
parameters:
- name: language
in: path
description: The target language for the client library
required: true
schema:
type: string
enum:
- ada
- akka-scala
- android
- apex
- bash
- clojure
- cpprest
- csharp
- csharp-dotnet2
- cwiki
- dart
- dart-jaguar
- dynamic-html
- eiffel
- elixir
- elm
- erlang-client
- flash
- go
- groovy
- haskell-http-client
- html
- html2
- java
- javascript
- javascript-closure-angular
- jaxrs-cxf-client
- jmeter
- kotlin
- lua
- objc
- perl
- php
- powershell
- python
- qt5cpp
- r
- ruby
- rust
- scala
- scalaz
- swagger
- swagger-yaml
- swift
- swift3
- swift4
- swift5
- tizen
- typescript-angular
- typescript-angularjs
- typescript-aurelia
- typescript-fetch
- typescript-inversify
- typescript-jquery
- typescript-node
- ue4cpp
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/CliOption'
post:
tags:
- Clients
summary: Generates a client library
description: Accepts a `GeneratorInput` options map for spec location and generation options
operationId: generateClient
parameters:
- name: language
in: path
description: The target language for the client library
required: true
schema:
type: string
enum:
- ada
- akka-scala
- android
- apex
- bash
- clojure
- cpprest
- csharp
- csharp-dotnet2
- cwiki
- dart
- dart-jaguar
- dynamic-html
- eiffel
- elixir
- elm
- erlang-client
- flash
- go
- groovy
- haskell-http-client
- html
- html2
- java
- javascript
- javascript-closure-angular
- jaxrs-cxf-client
- jmeter
- kotlin
- lua
- objc
- perl
- php
- powershell
- python
- qt5cpp
- r
- ruby
- rust
- scala
- scalaz
- swagger
- swagger-yaml
- swift
- swift3
- swift4
- swift5
- tizen
- typescript-angular
- typescript-angularjs
- typescript-aurelia
- typescript-fetch
- typescript-inversify
- typescript-jquery
- typescript-node
- ue4cpp
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/ResponseCode'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GeneratorInput'
description: Configuration for building the client library
required: true
servers:
- url: https://generator.swagger.io/api
/gen/clients:
get:
tags:
- Clients
summary: Gets languages supported by the client generator
description: ''
operationId: clientOptions
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
type: string
servers:
- url: https://generator.swagger.io/api
/generate:
get:
tags:
- Clients
summary: Generates and download code.
operationId: generateFromURL
parameters:
- name: codegenOptionsURL
in: query
required: true
schema:
type: string
responses:
'200':
description: successful operation
content:
application/octet-stream:
schema:
type: string
format: binary
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
post:
tags:
- Clients
summary: Generates and download code. GenerationRequest input provided as request body
operationId: generate
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenerationRequest'
responses:
'200':
description: successful operation
content:
application/octet-stream:
schema:
type: string
format: binary
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
/clients:
get:
tags:
- Clients
summary: Deprecated, use '/{type}/{version}' instead.
operationId: clientLanguages
parameters:
- $ref: '#/components/parameters/version'
- name: clientOnly
in: query
description: flag to only return languages of type `client`
schema:
type: boolean
default: false
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
type: string
deprecated: true
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
/{type}/{version}:
get:
tags:
- Clients
summary: List generator languages of the given type and version
operationId: languages
parameters:
- $ref: '#/components/parameters/type'
- name: version
in: path
description: generator version used by codegen engine
required: true
schema:
type: string
enum:
- V2
- V3
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
type: string
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
/types:
get:
tags:
- Clients
summary: List generator languages of version defined in 'version parameter (defaults to…
operationId: languagesMulti
parameters:
- $ref: '#/components/parameters/types'
- $ref: '#/components/parameters/version'
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
type: string
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
/options:
get:
tags:
- Clients
summary: Returns options for a given language and version (defaults to V3)
operationId: listOptions
parameters:
- name: language
in: query
description: language
schema:
type: string
- $ref: '#/components/parameters/version'
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/CliOption'
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
/model:
post:
tags:
- Clients
summary: Generates the intermediate model ("bundle") and returns it as a JSON. body
operationId: generateBundle
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenerationRequest'
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: object
x-swagger-router-controller: io.swagger.v3.generator.online.GeneratorController
servers:
- url: /api
components:
schemas:
SecuritySchemeDefinition:
type: object
properties:
type:
type: string
description:
type: string
GeneratorInput:
type: object
properties:
spec:
type: object
options:
type: object
additionalProperties:
type: string
swaggerUrl:
type: string
example: http://petstore.swagger.io/v2/swagger.json
authorizationValue:
$ref: '#/components/schemas/AuthorizationValue'
usingFlattenSpec:
type: boolean
securityDefinition:
$ref: '#/components/schemas/SecuritySchemeDefinition'
CliOption:
type: object
properties:
optionName:
type: string
description:
type: string
type:
type: string
description: Data type is based on the types supported by the JSON-Schema
enum:
type: object
additionalProperties:
type: string
default:
type: string
AuthorizationValue:
type: object
properties:
value:
type: string
type:
type: string
keyName:
type: string
urlMatcher:
$ref: '#/components/schemas/UrlMatcher'
ResponseCode:
type: object
properties:
code:
type: string
example: d40029be-eda6-4d62-b1ef-d05e2e91a72a
description: File download code
link:
type: string
example: http://generator.swagger.io:80/api/gen/download/d40029be-eda6-4d62-b1ef-d05e2e91a72a
description: URL for fetching the generated client
UrlMatcher:
type: object
Options:
type: object
properties:
auth:
title: authorization
type: string
description: adds authorization headers when fetching the open api definitions remotely. Pass in a URL-encoded string of name:header with a comma separating multiple values
authorizationValue:
$ref: '#/components/schemas/AuthorizationValue_2'
apiPackage:
title: api package
type: string
description: package for generated api classes
templateVersion:
title: Template Version
type: string
description: template version for generation
modelPackage:
title: model package
type: string
description: package for generated models
modelNamePrefix:
title: model name prefix
type: string
description: Prefix that will be prepended to all model names. Default is the empty string.
modelNameSuffix:
title: model name suffix
type: string
description: PrefixSuffix that will be appended to all model names. Default is the empty string.
systemProperties:
title: System Properties
type: object
additionalProperties:
type: string
description: sets specified system properties in key/value format
instantiationTypes:
title: instantiation types
type: object
additionalProperties:
type: string
description: 'sets instantiation type mappings in key/value format. For example (in Java): array=ArrayList,map=HashMap. In other words array types will get instantiated as ArrayList in generated code.'
typeMappings:
title: type mappings
type: object
additionalProperties:
type: string
description: 'sets mappings between swagger spec types and generated code types in key/value format. For example: array=List,map=Map,string=String.'
additionalProperties:
title: additional properties
type: object
additionalProperties:
type: object
description: sets additional properties that can be referenced by the mustache templates in key/value format.
languageSpecificPrimitives:
title: language specific primitives
type: array
description: 'specifies additional language specific primitive types in the format of type1,type2,type3,type3. For example: String,boolean,Boolean,Double. You can also have multiple occurrences of this option.'
items:
type: string
importMappings:
title: import mappings
type: object
additionalProperties:
type: string
description: specifies mappings between a given class and the import that should be used for that class in key/value format.
invokerPackage:
title: invoker package
type: string
description: root package for generated code
groupId:
title: group id
type: string
description: groupId in generated pom.xml
artifactId:
title: artifact id
type: string
description: artifactId in generated pom.xml
artifactVersion:
title: artifact version
type: string
description: artifact version generated in pom.xml
library:
title: library
type: string
description: library template (sub-template)
gitUserId:
title: git user id
type: string
description: Git user ID, e.g. swagger-api.
gitRepoId:
title: git repo id
type: string
description: Git repo ID, e.g. swagger-codegen.
releaseNote:
title: release note
type: string
description: Release note, default to 'Minor update'.
httpUserAgent:
title: http user agent
type: string
description: HTTP user agent, e.g. codegen_csharp_api_client, default to 'Swagger-Codegen/{packageVersion}}/{language}'
reservedWordsMappings:
title: reserved words mappings
type: object
additionalProperties:
type: string
description: pecifies how a reserved name should be escaped to. Otherwise, the default _<name> is used. For example id=identifier.
ignoreFileOverride:
title: ignore file override location
type: string
description: Specifies an override location for the .swagger-codegen-ignore file. Most useful on initial generation.
removeOperationIdPrefix:
title: remove prefix of the operationId
type: boolean
description: Remove prefix of operationId, e.g. config_getId => getId
skipOverride:
type: boolean
x-swagger-router-model: io.swagger.codegen.v3.service.Options
AuthorizationValue_2:
title: authorization
type: object
properties:
value:
type: string
description: Authorization value
keyName:
type: string
description: Authorization key
type:
type: string
description: Authorization type
enum:
- query
- header
description: adds authorization headers when fetching the open api definitions remotely. Pass in an authorizationValue object
x-swagger-router-model: io.swagger.v3.parser.core.models.AuthorizationValue
GenerationRequest:
required:
- lang
type: object
properties:
lang:
title: language
type: string
description: language to generate (required)
example: java
spec:
type: object
description: spec in json format. . Alternative to `specURL`
specURL:
type: string
description: URL of the spec in json format. Alternative to `spec`
type:
type: string
description: type of the spec
enum:
- CLIENT
- SERVER
- DOCUMENTATION
- CONFIG
codegenVersion:
type: string
description: codegen version to use
enum:
- V2
- V3
options:
$ref: '#/components/schemas/Options'
x-swagger-router-model: io.swagger.codegen.v3.service.GenerationRequest
parameters:
type:
name: type
in: path
description: generator type
required: true
schema:
type: string
enum:
- client
- server
- documentation
- config
version:
name: version
in: query
description: generator version used by codegen engine
schema:
type: string
enum:
- V2
- V3
types:
name: types
in: query
description: comma-separated list of generator types
required: true
style: form
explode: false
schema:
type: array
items:
type: string
enum:
- client
- server
- documentation
- config
x-refined-from:
- swagger-generator-v2-swagger-original.json
- swagger-generator-v3-openapi-original.json