Read one buy box
curl --request GET \
--url https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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_id",
"title": "Identifier malformed",
"status": 400,
"code": "invalid_id",
"detail": "<string>",
"recovery": "Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6.",
"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#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
Read one buy box
Reads one buy box of this buyer.
GET
/
buy
/
buy-boxes
/
{buy_box_id}
Read one buy box
curl --request GET \
--url https://api.investorlift.com/marketplace/v1/buy/buy-boxes/{buy_box_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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_id",
"title": "Identifier malformed",
"status": 400,
"code": "invalid_id",
"detail": "<string>",
"recovery": "Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6.",
"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#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.
Was this page helpful?