swagger: '2.0' info: version: 0.1.1 title: test 1 description: recursively following JSON references contact: name: Fred schemes: - http consumes: - application/json produces: - application/json paths: /getAll: get: operationId: getAll parameters: - name: a in: body description: max number of results required: false schema: $ref: '#/definitions/a' responses: '200': description: Success schema: $ref: '#/definitions/b' '203': description: Success schema: $ref: '#/definitions/c' definitions: a: type: string b: $ref: 'test3-model-schema.json#/definitions/b' c: $ref: 'test3-model-schema.json#/definitions/c'