Auctions can be retrieved by using the following URL and specifying a starting record number and ending record number. If left blank, this will default to the first 50 records. Auctions are returned in order of occurance, with the earlier auctions first.
| Method | URL |
| GET | https://api.fairwarningsoftware.com/v1.1.1/auctions/[start]/[limit] |
| Status | Response |
| 200 |
{"auctions":[ |
| 401 | {"error":"The API keys provided are invalid."} |
| 403 | {"error":"API keys are missing."} |
| 500 | {"error": <custom error>} |
| Field | Type | Description |
| auction_id | int | The unique identifier for the auction |
| company_id | int | The ID for your company |
| auction_lock | bool | Whether the auction is locked or not |
| auction_hide | bool | Whether the auction is hidden or not |
| auction_preview | bool | Whether the auction can be previewed or not |
| auction_event | bool | Whether the auction is an event or not |
| type_id | int | The ID for the type of auction it is |
| type_name | string | The name for the type of auction it is |
| office_id | int | The ID for the office set for the auction |
| office_name | string | The name for the office set for the auction |
| department_id | int | The ID for the department set for the auction |
| department_name | string | The name for the department set for the auction |
| auction_date | datetime | The date and time of the auction |
| auction_name | string | The name of the auction |
| auction_slug | string | The slug for the auction, with a possible multi-day ID on the end |
| auction_bidder_type_ids | string | A JSON formatted string containing the different bidder types that can bid in this auction |
| bidsquare_ids | string | A JSON formatted string containing the different Bidsquare catalog IDS and lot ranges for each catalog |
| auction_description | string | The description provided for the auction |
| auction_comments | string | Additional comments provided for the auction |
| auction_terms | string | The terms and conditions for the auction |
| auction_event_description | string | The description for the auction event |
| external_bidding_id | int | The ID of the system entry for the external website selected. |
| external_bidding_url | string | The external website URL to the catalog associated with this auction. |
| external_bidding_logo | string | The logo for the external website selected. |
| system_type_id | int | The system type ID associated with this auction |
| system_type_name | string | The system type name associated with this auction |
| past_auction | bool | Whether the auction is a past auction or not. |
| item_count | int | The number of items associated with this auction |
| primary_image | object | An object containing the base and paths to the different image sizes of the primary image |
| base | string | The base will contain the first part of the URL needed to retrieve the specified image. |
| parts | object | This will contain an array of URL parts for the different sizes of images. |
| large | string | The end of the URL to retrieve a large-sized image. |
| medium | string | The end of the URL to retrieve a medium-sized image. |
| small | string | The end of the URL to retrieve a small-sized image. |
| event_image | string | An object containing the base and paths to the different image sizes of the primary image |
| base | string | The base will contain the first part of the URL needed to retrieve the specified image. |
| parts | object | This will contain an array of URL parts for the different sizes of images. |
| large | string | The end of the URL to retrieve a large-sized image. |
| medium | string | The end of the URL to retrieve a medium-sized image. |
| small | string | The end of the URL to retrieve a small-sized image. |
| external_bidding_websites | string | An object containing the list of selected external websites to be used for live bidding |
| external_site | object | This will contain an array of URL's and images. |
| external_url | string | The URL to be used to link to the external bidding website. |
| external_logo | string | The logo to be used to link to the external bidding website. |
| auction_current_item | string | The current item the auctioneer is on during a live auction |
| record_count | int | The total number of records matching the search results |
You may also choose to search the auctions in order to retrieve more specific results. For instance, if you are only looking for auctions in a certain category, you could pass query parameters to specify the category ID you want the auction results to belong to.
{ "department_id": { "operator" : "equals", "value": 59 } }
By passing this data string as raw post data, you will limit your results to only auctions that belong to the department with the department ID of 59.
You may also wish to only get a list of auctions that are prior to a certain date that belong to department 59. In that case, you could add a second parameter to your search like so:
{ "department_id": { "operator" : "equals", "value": 59 }, "auction_date": { "operator" : "less_than_equal", "value": "2016-06-01 00:00:00" } }
In this way, you will limit the search results to both the department ID and the auction date.
Below is a list of search fields that you can perform a full text search on: