sample-swagger.json

swagger: "2.0"
info:
  description: "This is the HRSA Applicant Service."
  version: "1.0.0"
  title: "HRSA Applicant Service"
  termsOfService: "http://swagger.io/terms/"
  contact:
    email: "info@example.com"
  license:
    name: "Apache 2.0"
    url: "http://www.apache.org/licenses/LICENSE-2.0.html"
host: "services.hrsa.gov"
basePath: "/v1"
tags:
- name: "applicant"
  description: "applicant service definition"
  externalDocs:
    description: "Find out more"
    url: "http://swagger.io"
schemes:
- "http"
paths:
  /applicants:
    post:
      tags:
      - "applicant"
      summary: "Add a new applicant to the EHB datastore"
      description: ""
      operationId: "addApplicant"
      consumes:
      - "application/json"
      - "application/xml"
      produces:
      - "application/xml"
      - "application/json"
      parameters:
      - in: "body"
        name: "body"
        description: "Applicant Details including Legal Name, EINI, Organizational DUNS"
        required: true
        schema:
          $ref: "#/definitions/Applicant"
      responses:
        405:
          description: "Invalid input"
      security:
      - petstore_auth:
        - "write:applicants"
        - "read:applicants"
securityDefinitions:
  petstore_auth:
    type: "oauth2"
    authorizationUrl: "http://auth.hrsa.gov/oauth/dialog"
    flow: "implicit"
    scopes:
      write:applicants: "modify applicants record"
      read:applicants: "read applicants record"
  api_key:
    type: "apiKey"
    name: "api_key"
    in: "header"
definitions:
  Applicant:
    type: "object"
    properties:
      id:
        type: "integer"
        format: "int64"
      legalName:
        type: "string"
      ein:
        type: "string"
      duns:
        type: "string"