You can submit or edit 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/[item-id] |
| Request |
| { "user_id": <user_id>, "bid_amount": <bid_amount>, "phone_1": <phone_1>, "phone_2": <phone_2>, "phone_3": <phone_3>, "phone_1_country_code": <phone_1_country_code>, "phone_2_country_code": <phone_2_country_code>, "phone_3_country_code": <phone_3_country_code> } |
| Field | Type | Description |
| user_id | int | The ID of the user placing the bid. |
| bid_amount | decimal | The amount of the insurance bid, if any. |
| phone_1 | string | The primary phone number to be contacted at. |
| phone_2 | string | The secondary phone number to be contacted at. |
| phone_3 | string | The tertiary phone number to be contacted at. |
| phone_1_country_code | string | The ISO code of the country for the phone number. |
| phone_2_country_code | string | The ISO code of the country for the phone number. |
| phone_3_country_code | string | The ISO code of the country for the phone number. |
If successful, a success response will be returned. If not, an error will be returned instead.
| Status | Response |
| 200 | { "success": <success> } |
| 401 | {"error":"The API keys provided are invalid."} |
| 403 | {"error":"API keys are missing."} |
| 500 | {"error": <custom error>} |
| Field | Type | Description |
| success | bool | Whether or not the request was successful |