Preview an answer to an open round
curl --request POST \
--url https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id}/counter/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"offer_amount": 123,
"emd_amount": 123,
"note": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({offer_amount: 123, emd_amount: 123, note: '<string>'})
};
fetch('https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id}/counter/preview', 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}/counter/preview"
payload = {
"offer_amount": 123,
"emd_amount": 123,
"note": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"deal": {
"id": "<string>",
"status": "<string>",
"asking_price": 0,
"min_emd": 0,
"floor_amount": 0
},
"terms": {
"offer_amount": 0,
"emd_amount": 0,
"financing": "cash",
"note": "<string>"
},
"requirements": [
{
"code": "deal_offerable",
"met": true,
"blocking": true
}
],
"can_submit": true,
"open_offer_id": "<string>",
"standing": {
"tier": "T0",
"offers_left_today": 0,
"previews_left_today": 0,
"active_chains": 0,
"active_chains_limit": 0
},
"preview_token": "<string>",
"expires_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#api_offers_disabled",
"title": "Seller refuses API offers",
"status": 403,
"code": "api_offers_disabled",
"detail": "<string>",
"recovery": "Contact the seller outside the API, because this seller takes no offer through it.",
"request_id": "<string>"
}{
"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#deal_closed",
"title": "Deal closed",
"status": 409,
"code": "deal_closed",
"detail": "<string>",
"recovery": "Read the deal to see the current status, and act on an open deal instead.",
"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#cap_reached",
"title": "Cap reached",
"status": 429,
"code": "cap_reached",
"detail": "<string>",
"recovery": "Wait for the time in Retry-After, or raise your trust tier with the step in GET /me.",
"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
Preview an answer to an open round
Measures an answer to the open round of your chain. Send terms to preview a counter. Send an empty body to preview an accept of the round as it stands. It writes nothing and answers a token that lives five minutes.
POST
/
buy
/
offers
/
{offer_id}
/
counter
/
preview
Preview an answer to an open round
curl --request POST \
--url https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id}/counter/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"offer_amount": 123,
"emd_amount": 123,
"note": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({offer_amount: 123, emd_amount: 123, note: '<string>'})
};
fetch('https://api.investorlift.com/marketplace/v1/buy/offers/{offer_id}/counter/preview', 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}/counter/preview"
payload = {
"offer_amount": 123,
"emd_amount": 123,
"note": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"deal": {
"id": "<string>",
"status": "<string>",
"asking_price": 0,
"min_emd": 0,
"floor_amount": 0
},
"terms": {
"offer_amount": 0,
"emd_amount": 0,
"financing": "cash",
"note": "<string>"
},
"requirements": [
{
"code": "deal_offerable",
"met": true,
"blocking": true
}
],
"can_submit": true,
"open_offer_id": "<string>",
"standing": {
"tier": "T0",
"offers_left_today": 0,
"previews_left_today": 0,
"active_chains": 0,
"active_chains_limit": 0
},
"preview_token": "<string>",
"expires_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#api_offers_disabled",
"title": "Seller refuses API offers",
"status": 403,
"code": "api_offers_disabled",
"detail": "<string>",
"recovery": "Contact the seller outside the API, because this seller takes no offer through it.",
"request_id": "<string>"
}{
"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#deal_closed",
"title": "Deal closed",
"status": 409,
"code": "deal_closed",
"detail": "<string>",
"recovery": "Read the deal to see the current status, and act on an open deal instead.",
"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#cap_reached",
"title": "Cap reached",
"status": 429,
"code": "cap_reached",
"detail": "<string>",
"recovery": "Wait for the time in Retry-After, or raise your trust tier with the step in GET /me.",
"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.
Body
application/json
What the buyer counters with. Leave it out to preview an accept. Whole dollars.
Required range:
x <= 9007199254740991The earnest money deposit of the counter. Whole dollars.
Required range:
x <= 9007199254740991Available options:
cash, lender A note to the seller, at most 500 characters.
Maximum string length:
500Was this page helpful?