title: How to make Swagger show examples of objects returned from the API?
body: <p>I am creating a set of API's for the first time.  Here's one of the methods:</p>
  
  <pre><code>    // GET: api/Doors/0
      /// &lt;summary&gt;
      /// Get a list of all doors for a given organization.
      /// &lt;/summary&gt;
      /// &lt;param name="organizationSys"&gt;The Organization ID for which all doors should be retreived.&lt;/param&gt;
      /// &lt;returns&gt;&lt;/returns&gt;
      [Route("{organizationSys:int}")]
      public IHttpActionResult Get(int organizationSys)
      {
          try
          {
              Dictionary&lt;string, object&gt; parameters = new Dictionary&lt;string, object&gt;();
              parameters.Add("@OrganizationSys", organizationSys);
              List&lt;Door&gt; doors = Repository&lt;Doors&gt;.GetList("WHERE OrganizationSys = @OrganizationSys", parameters).ToList();
              if (doors == null || doors.Count() == 0)
                  return Content(HttpStatusCode.NotFound, RejectionMessage.NoItemsFound);
  
              return Ok(doors);
          }
          catch (Exception ex)
          {
              return Content(HttpStatusCode.BadRequest, ex.Message);
          }
      }
  </code></pre>
  
  <p>I've set up a Unit Test to this endpoint, and it works perfectly.  However, I do have one question.</p>
  
  <p>In Swagger, I'd like to show an example of the data object that will be returned.  The only return type on the method is <code>IHttpActionResult</code> so I'm not surprised it's not showing the data model in Swagger.  So, what do I need to change with this method so that the return object (in this case <code>List&lt;Door&gt;</code>) will be more visible?</p>
  
  <p>Does Swashbuckle support this?</p>
  
  <p>Thanks!</p>