How to retrieve a phone bid registration request

You can retrieve a phone bid request for a user by using the following URL and specifying the required parameters.

 

 Method URL
 POST  https://api.fairwarningsoftware.com/v1.1.1/phone/get/[item-id]

 

Request
{
        "user_id": <user_id>
}

 

 Field  Type Description
user_id int The ID of the user that placed the bid.

 

If successful, the phone bid placed will be returned.  If not, an error will be returned instead.

 Status Response
 200

{
        "bid_id": <bid_id>,
        "auction_id": <auction_id>,
        "bid_date": <bid_date>,
        "bidder_id": <bidder_id>,
        "bider_number": <bider_number>,
        "item_id": <item_id>,
        "bid_amount": <bid_amount>,
        "bid_phone_1": <bid_phone_1>,
        "bid_phone_2": <bid_phone_2>,
        "bid_phone_3": <bid_phone_3>,
        "bid_phone_1_country_code": <phone_1_country_code>,
        "bid_phone_2_country_code": <phone_2_country_code>,
        "bid_phone_3_country_code": <phone_3_country_code>,
        "bid_active": <bid_active>
}
401  {"error":"The API keys provided are invalid."}
403  {"error":"API keys are missing."}
500  {"error": <custom error>}

 

 Field  Type Description
bid_id int The ID of the phone bid placed.
auction_id int The ID of the auction the item bid on is in.
bid_date timestamp The date and time the bid was placed.
bidder_id int The ID of the bidder placing the bid.
bidder_number string The number of the bidder placing the bid.
item_id int The ID of the item the bid was placed on.
bid_amount decimal The insurance amount left for the bid.
bid_phone_1 string The primary phone number left for the bid.
bid_phone_2 string The secondary phone number left for the bid.
bid_phone_3 string The tertiary phone number left for the bid.
bid_phone_1_country_code string The country phone code for the phone number.
bid_phone_2_country_code string The country phone code for the phone number.
bid_phone_3_country_code string The country phone code for the phone number.
bid_active int Whether the bid is active or not.