Change one buy box
curl --request PATCH \
--url https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"name": "<string>",
"is_default": true,
"geo_feature_ids": [
"<string>"
],
"criteria": {
"price_min": 4503599627370495,
"price_max": 4503599627370495,
"arv_min": 4503599627370495,
"beds_min": 4503599627370495,
"beds_max": 4503599627370495,
"baths_min": 1,
"baths_max": 1,
"sq_footage_min": 4503599627370495,
"sq_footage_max": 4503599627370495,
"year_built_min": 4503599627371296,
"year_built_max": 4503599627371296,
"property_type": [
"single_family"
],
"deal_type": [
"subject_to"
],
"asset_type": [
"property"
],
"condition_min": "FULL_GUT",
"condition_max": "FULL_GUT",
"verified_only": true
},
"alerts": {
"webhook": true
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"api_version": "<string>"
}
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_body",
"title": "Body unusable",
"status": 400,
"code": "invalid_body",
"detail": "<string>",
"recovery": "Send a JSON body with the content type application/json.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#unauthorized",
"title": "Not authenticated",
"status": 401,
"code": "unauthorized",
"detail": "<string>",
"recovery": "Send a current access token for this API, and start a new authorization when the token is expired.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#designation_required",
"title": "Designation missing",
"status": 403,
"code": "designation_required",
"detail": "<string>",
"recovery": "Finish the onboarding of the side you call, then repeat the call.",
"request_id": "<string>",
"designation": "seller"
}{
"type": "https://developers.investorlift.com/marketplace/errors#not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"recovery": "Check the id, and check that the account you call with owns the resource.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "<string>",
"recovery": "Use one of the methods the documentation lists for this path.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#validation_failed",
"title": "Body failed validation",
"status": 422,
"code": "validation_failed",
"detail": "<string>",
"recovery": "Correct each field the detail names, then repeat the call.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#origin_error",
"title": "Service unavailable",
"status": 503,
"code": "origin_error",
"detail": "<string>",
"recovery": "Repeat the call in a minute, and tell Investorlift support when the answer stays the same.",
"request_id": "<string>"
}buy
Change one buy box
Changes the name, the geography features, the criteria, the default flag or the alert switch of one buy box. The box keeps at least one geography feature and a price range. Set alerts.webhook to true to get deal.matched events for this box.
PATCH
/
buy
/
buy-boxes
/
{buy_box_id}
Change one buy box
curl --request PATCH \
--url https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"name": "<string>",
"is_default": true,
"geo_feature_ids": [
"<string>"
],
"criteria": {
"price_min": 4503599627370495,
"price_max": 4503599627370495,
"arv_min": 4503599627370495,
"beds_min": 4503599627370495,
"beds_max": 4503599627370495,
"baths_min": 1,
"baths_max": 1,
"sq_footage_min": 4503599627370495,
"sq_footage_max": 4503599627370495,
"year_built_min": 4503599627371296,
"year_built_max": 4503599627371296,
"property_type": [
"single_family"
],
"deal_type": [
"subject_to"
],
"asset_type": [
"property"
],
"condition_min": "FULL_GUT",
"condition_max": "FULL_GUT",
"verified_only": true
},
"alerts": {
"webhook": true
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"api_version": "<string>"
}
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_body",
"title": "Body unusable",
"status": 400,
"code": "invalid_body",
"detail": "<string>",
"recovery": "Send a JSON body with the content type application/json.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#unauthorized",
"title": "Not authenticated",
"status": 401,
"code": "unauthorized",
"detail": "<string>",
"recovery": "Send a current access token for this API, and start a new authorization when the token is expired.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#designation_required",
"title": "Designation missing",
"status": 403,
"code": "designation_required",
"detail": "<string>",
"recovery": "Finish the onboarding of the side you call, then repeat the call.",
"request_id": "<string>",
"designation": "seller"
}{
"type": "https://developers.investorlift.com/marketplace/errors#not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"recovery": "Check the id, and check that the account you call with owns the resource.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "<string>",
"recovery": "Use one of the methods the documentation lists for this path.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#validation_failed",
"title": "Body failed validation",
"status": 422,
"code": "validation_failed",
"detail": "<string>",
"recovery": "Correct each field the detail names, then repeat the call.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#origin_error",
"title": "Service unavailable",
"status": 503,
"code": "origin_error",
"detail": "<string>",
"recovery": "Repeat the call in a minute, and tell Investorlift support when the answer stays the same.",
"request_id": "<string>"
}Authorizations
Authorization code with PKCE. The person grants the scopes on the Investorlift consent page and accepts the Marketplace API Terms there.
Path Parameters
The public id in the path, for example buy_box_id as mdl_a1b2c3d4e5f6.
Body
application/json
Required string length:
2 - 120Required array length:
1 - 25 elementsMinimum string length:
1Show child attributes
Show child attributes
Send true to make this box the default. A buyer always keeps one default.
The alert switch of the box. A body with no alerts member keeps the switch.
Show child attributes
Show child attributes
Was this page helpful?