Read one of your offers
curl --request GET \
--url https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/marketplace/v1/buy/offers/{offer_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/offers/{offer_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"offer_amount": 123,
"emd_amount": 123,
"financing": "cash",
"submitted_by": "buyer",
"round": 0,
"parent_offer_id": "<string>",
"root_offer_id": "<string>",
"note": "<string>",
"decline_reason": "price_too_low",
"channel": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"chain": [
{
"id": "<string>",
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"offer_amount": 123,
"emd_amount": 123,
"financing": "cash",
"submitted_by": "buyer",
"round": 0,
"parent_offer_id": "<string>",
"root_offer_id": "<string>",
"note": "<string>",
"decline_reason": "price_too_low",
"channel": "<string>",
"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>"
}Reference: buy
Read one of your offers
Reads one round you take part in with every round of its chain, oldest first.
GET
/
buy
/
offers
/
{offer_id}
Read one of your offers
curl --request GET \
--url https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/marketplace/v1/buy/offers/{offer_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/offers/{offer_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"offer_amount": 123,
"emd_amount": 123,
"financing": "cash",
"submitted_by": "buyer",
"round": 0,
"parent_offer_id": "<string>",
"root_offer_id": "<string>",
"note": "<string>",
"decline_reason": "price_too_low",
"channel": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"chain": [
{
"id": "<string>",
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"offer_amount": 123,
"emd_amount": 123,
"financing": "cash",
"submitted_by": "buyer",
"round": 0,
"parent_offer_id": "<string>",
"root_offer_id": "<string>",
"note": "<string>",
"decline_reason": "price_too_low",
"channel": "<string>",
"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 offer_id as mdl_a1b2c3d4e5f6.
Was this page helpful?