fields.html

---
layout: default
title: Field Reference
nav: fields
---

<h5>GSA Auctions API Data Fields</h5>
<table border="1" cellspacing="0" cellpadding="0"> 
<tbody>
<tr>
<td valign="top"><p><b>Data Name</b></p></td>
<td valign="top"><p><b>Data type</b></p></td>
<td valign="top"><p><b>Data Length</b></p></td>
<td valign="top"><p><b>Description</b></p></td>
</tr>

<tr>
<td>SaleNo</td>
<td>String</td>
<td>11</td>
<td>This field identifies a specific sale number created by the region</td>
</tr>

<tr>
<td>LotNo</td>
<td>Numeric</td>
<td>3</td>
<td>This code indicating the sequential order in which an item appears on an invitation for bid</td>
</tr>

<tr>
<td>AucStartDt</td>
<td>String</td>
<td>10</td>
<td>Auction start date</td>
</tr>

<tr>
<td>AucEndDt</td>
<td>String</td>
<td>10</td>
<td>Auction end date</td>
</tr>

<tr>
<td>ItemName</td>
<td>String</td>
<td>69</td>
<td>This is the brief description of the item</td>
</tr>

<tr>
<td>PropertyAddr1</td>
<td>String</td>
<td>36</td>
<td>Agency name where property is located</td>
</tr>

<tr>
<td>PropertyAddr2</td>
<td>String</td>
<td>3</td>
<td>Agency 2nd line of clear text address</td>
</tr>

<tr>
<td>PropertyAddr3</td>
<td>String</td>
<td>36</td>
<td>P.O. Box/street address name of  where property is located</td>
</tr>

<tr>
<td>PropertyCity</td>
<td>String</td>
<td>29</td>
<td>Property location city</td>
</tr>

<tr>
<td>PropertyState</td>
<td>String</td>
<td>2</td>
<td>Property location state</td>
</tr>

<tr>
<td>PropertyZip</td>
<td>Numeric</td>
<td>9</td>
<td>Property location zip code</td>
</tr>

<tr>
<td>AuctionStatus</td>
<td>String</td>
<td>1</td>
<td>Status of sale, values are A=Active, P=Preview, Space=Scheduled</td>
</tr>

<tr>
<td>SaleLocation</td>
<td>String</td>
<td>36</td>
<td>Location of sale</td>
</tr>

<tr>
<td>LocationOrg</td>
<td>String</td>
<td>36</td>
<td>Location organizational subdivision</td>
</tr>

<tr>
<td>LocationStAddr</td>
<td>String</td>
<td>36</td>
<td>Location P.O. Box/Street address</td>
</tr>

<tr>
<td>LocationCity</td>
<td>String</td>
<td>29</td>
<td>City sale Location</td>
</tr>

<tr>
<td>LocationST</td>
<td>String</td>
<td>2</td>
<td>State abbreviation location</td>
</tr>

<tr>
<td>LocationZip</td>
<td>Numeric</td>
<td>9</td>
<td>Sale location zip code</td>
</tr>

<tr>
<td>BiddersCount</td>
<td>Numeric</td>
<td>5</td>
<td>Number of Bidders on the sale</td>
</tr>

<tr>
<td>LotSequence</td>
<td>Numeric</td>
<td>3</td>
<td>Lot Sequence Number</td>
</tr>

<tr>
<td>LotDescript</td>
<td>String</td>
<td>50</td>
<td>Lot Description</td>
</tr>

<tr>
<td>Instruction1</td>
<td>String</td>
<td>63</td>
<td>Special Inspection Instructions Line 1</td>
</tr>

<tr>
<td>Instruction2</td>
<td>String</td>
<td>63</td>
<td>Special Inspection Instructions Line 2</td>
</tr>

<tr>
<td>Instruction3</td>
<td>String</td>
<td>63</td>
<td>Special Inspection Instructions Line 3</td>
</tr>

<tr>
<td>ContractOfficer</td>
<td>String</td>
<td>35</td>
<td>The Sales Contracting Officer that is assigned to the sale</td>
</tr>
 
<tr>
<td>COEmail</td>
<td>String</td>
<td>65</td>
<td>The Email address for the Sales Contracting Officer that is assigned to the sale</td>
</tr>

<tr>
<td>COPhone</td>
<td>String</td>
<td>10</td>
<td>The Phone number for the Sales Contracting Officer that is assigned to the sale</td>
</tr>

<tr>
<td>Reserve</td>
<td>Numeric</td>
<td>8.2</td>
<td>The minimum dollar amount that the sale must reach before it may be awarded to a bidder</td>
</tr>

<tr>
<td>AucIncrement</td>
<td>Numeric</td>
<td>6.2</td>
<td>The bid increment that the sale use during the bidding process</td>
</tr>

<tr>
<td>HighBidAmount</td>
<td>Numeric</td>
<td>8.2</td>
<td>Highest bid amount </td>
</tr>

<tr>
<td>InactivityTime</td>
<td>Numeric</td>
<td>4</td>
<td>The period of time in minutes that there is no bidding activity on a sale</td>
</tr>

<tr>
<td>AgencyCode</td>
<td>String</td>
<td>3</td>
<td>Agency Code</td>
</tr>

<tr>
<td>BureauCode</td>
<td>String</td>
<td>3</td>
<td>Bureau Code</td>
</tr>

<tr>
<td>AgencyName</td>
<td>String</td>
<td>80</td>
<td>Agency Name</td>
</tr>

<tr>
<td>BureauName</td>
<td>String</td>
<td>80</td>
<td>Bureau Name</td>
</tr>

<tr>
<td>ItemDescURL</td>
<td>String</td>
<td>72</td>
<td>Item description URL</td>
</tr>

<tr>
<td>ImageURL</td>
<td>String</td>
<td>66</td>
<td>URL of an item image</td>
</tr>

</tbody>
</table>


<h4>Common RESTful API Objects</h4>

<a name="addressObject"></a>
<h5>Date Object</h5>

The date format is in ISO 8601, in UTC.
<p>Example: 2013-02-27 </p>