> ## Documentation Index > Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt > Use this file to discover all available pages before exploring further. # Preview an answer to an open round > Measures an answer to the open round of your chain. ## OpenAPI ````yaml POST /buy/offers/{offer_id}/counter/preview openapi: 3.1.0 info: title: Investorlift Marketplace API version: '2026-09-18' summary: List, publish and trade wholesale real estate deals on Investorlift. description: >- The Marketplace API gives a seller organization and a buyer account the same actions the Investorlift application gives them. A seller creates a draft, publishes a deal, reads its leads and answers offers. A buyer searches deals, asks for an address, makes an offer and keeps a buy box. Every answer carries a request id, and every refusal carries a problem code with one recovery sentence. contact: name: Investorlift support email: support@investorlift.com servers: - url: https://api.investorlift.com/marketplace/v1 description: Production security: - oauth2: [] tags: - name: sell description: What a seller organization does with its drafts and deals. - name: buy description: What a buyer account does with deals, offers and buy boxes. - name: me description: What this token can do right now. - name: events description: >- What Investorlift sends to a webhook endpoint, one entry for each event type. paths: /buy/offers/{offer_id}/counter/preview: post: tags: - buy summary: Preview an answer to an open round description: >- 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. operationId: previewBuyOfferAnswer parameters: - name: offer_id in: path required: true description: The public id in the path, for example offer_id as mdl_a1b2c3d4e5f6. schema: type: string requestBody: required: true content: application/json: schema: type: object properties: offer_amount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 description: >- What the buyer counters with. Leave it out to preview an accept. Whole dollars. emd_amount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 description: The earnest money deposit of the counter. Whole dollars. financing: type: string enum: - cash - lender note: description: A note to the seller, at most 500 characters. type: string maxLength: 500 additionalProperties: false responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/OfferPreview' meta: $ref: '#/components/schemas/Meta' required: - data - meta additionalProperties: false '400': description: Body unusable, Identifier malformed, Parameter unknown headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.invalid_body' - $ref: '#/components/schemas/Problem.invalid_id' - $ref: '#/components/schemas/Problem.unknown_parameter' '401': description: Not authenticated headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.unauthorized' '403': description: >- Seller refuses API offers, Designation missing, Refused, Scope missing, Terms not accepted headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.api_offers_disabled' - $ref: '#/components/schemas/Problem.designation_required' - $ref: '#/components/schemas/Problem.forbidden' - $ref: '#/components/schemas/Problem.insufficient_scope' - $ref: '#/components/schemas/Problem.terms_required' '404': description: Not found headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.not_found' '405': description: Method not allowed headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.method_not_allowed' '409': description: Deal closed, Round closed, Other side acts next headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.deal_closed' - $ref: '#/components/schemas/Problem.offer_superseded' - $ref: '#/components/schemas/Problem.wrong_side' '422': description: Body failed validation headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.validation_failed' '429': description: Cap reached, Daily cap reached headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/Problem.cap_reached' - $ref: '#/components/schemas/Problem.daily_cap_reached' '503': description: Service unavailable headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem.origin_error' security: - oauth2: - offers:write components: headers: XRequestId: description: The id this answer shares with the Investorlift request log. schema: type: string schemas: OfferPreview: type: object properties: deal: type: object properties: id: type: string description: The deal id, mdl_. status: type: string description: The status of the deal at the preview. asking_price: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The asking price at the preview. Whole dollars. min_emd: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: The lowest earnest money deposit the deal takes. floor_amount: description: >- The lowest offer the seller takes. The seller chooses to disclose it. type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - id - status - asking_price - min_emd additionalProperties: false terms: type: object properties: offer_amount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 emd_amount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 financing: type: string enum: - cash - lender note: anyOf: - type: string - type: 'null' description: The note after the contact scrubber ran. required: - offer_amount - emd_amount - financing - note additionalProperties: false requirements: type: array items: type: object properties: code: type: string enum: - deal_offerable - api_offers_enabled - identity_verified - proof_of_funds_current - min_emd - above_floor - financing_accepted - no_open_offer - offer_cap - active_chain_cap met: type: boolean description: True when the offer meets this requirement now. blocking: type: boolean description: True when a submit fails while this requirement is unmet. required: - code - met - blocking additionalProperties: false can_submit: type: boolean description: True when every blocking requirement is met. open_offer_id: anyOf: - type: string description: The open round of this buyer on this deal. - type: 'null' standing: type: object properties: tier: type: string enum: - T0 - T1 - T2 - T3 description: >- The trust tier of this buyer, from T0 to T3. GET /me names each fact behind it. offers_left_today: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many new offers the tier still allows today. previews_left_today: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many previews the tier still allows today. active_chains: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many chains of this buyer are open now. active_chains_limit: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many chains the tier allows at one time. required: - tier - offers_left_today - previews_left_today - active_chains - active_chains_limit additionalProperties: false preview_token: type: string description: The token the submit sends back. It lives five minutes. expires_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ description: When the token expires. required: - deal - terms - requirements - can_submit - open_offer_id - standing - preview_token - expires_at additionalProperties: false Meta: type: object properties: request_id: type: string description: The id this answer shares with the log. api_version: type: string description: The contract version the body is rendered at. required: - request_id - api_version additionalProperties: false Problem.invalid_body: allOf: - $ref: '#/components/schemas/Problem' description: Body unusable. Send a JSON body with the content type application/json. properties: type: const: https://developers.investorlift.com/marketplace/errors#invalid_body title: const: Body unusable status: const: 400 code: const: invalid_body recovery: const: Send a JSON body with the content type application/json. Problem.invalid_id: allOf: - $ref: '#/components/schemas/Problem' description: >- Identifier malformed. Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6. properties: type: const: https://developers.investorlift.com/marketplace/errors#invalid_id title: const: Identifier malformed status: const: 400 code: const: invalid_id recovery: const: >- Send the public id with its type prefix, for example mdl_a1b2c3d4e5f6. Problem.unknown_parameter: allOf: - $ref: '#/components/schemas/Problem' description: >- Parameter unknown. Remove the parameter the detail names, because this operation reads no such field. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#unknown_parameter title: const: Parameter unknown status: const: 400 code: const: unknown_parameter recovery: const: >- Remove the parameter the detail names, because this operation reads no such field. unknown_parameters: type: array items: type: string description: Every field of the request this operation does not read. required: - unknown_parameters Problem.unauthorized: allOf: - $ref: '#/components/schemas/Problem' description: >- Not authenticated. Send a current access token for this API, and start a new authorization when the token is expired. properties: type: const: https://developers.investorlift.com/marketplace/errors#unauthorized title: const: Not authenticated status: const: 401 code: const: unauthorized recovery: const: >- Send a current access token for this API, and start a new authorization when the token is expired. Problem.api_offers_disabled: allOf: - $ref: '#/components/schemas/Problem' description: >- Seller refuses API offers. Contact the seller outside the API, because this seller takes no offer through it. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#api_offers_disabled title: const: Seller refuses API offers status: const: 403 code: const: api_offers_disabled recovery: const: >- Contact the seller outside the API, because this seller takes no offer through it. Problem.designation_required: allOf: - $ref: '#/components/schemas/Problem' description: >- Designation missing. Finish the onboarding of the side you call, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#designation_required title: const: Designation missing status: const: 403 code: const: designation_required recovery: const: Finish the onboarding of the side you call, then repeat the call. designation: description: The designation the side of this operation needs. type: string enum: - seller - buyer Problem.forbidden: allOf: - $ref: '#/components/schemas/Problem' description: >- Refused. Ask Investorlift support why the account, the client or the organization is stopped. properties: type: const: https://developers.investorlift.com/marketplace/errors#forbidden title: const: Refused status: const: 403 code: const: forbidden recovery: const: >- Ask Investorlift support why the account, the client or the organization is stopped. Problem.insufficient_scope: allOf: - $ref: '#/components/schemas/Problem' description: >- Scope missing. Start a new authorization that asks for the scope named in the detail. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#insufficient_scope title: const: Scope missing status: const: 403 code: const: insufficient_scope recovery: const: >- Start a new authorization that asks for the scope named in the detail. scope: type: string enum: - marketplace:profile - deals:read - deals:write - offers:read - offers:write - inquiries:read - inquiries:write - leads:read - leads:write - contacts:read - reviews:read - buy_boxes:manage - webhooks:manage - events:read description: The scope this operation needs. required: - scope Problem.terms_required: allOf: - $ref: '#/components/schemas/Problem' description: >- Terms not accepted. Accept the Marketplace API Terms on the consent page, then start a new authorization. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#terms_required title: const: Terms not accepted status: const: 403 code: const: terms_required recovery: const: >- Accept the Marketplace API Terms on the consent page, then start a new authorization. agreement_id: type: string description: The version of the Marketplace API Terms to accept. required: - agreement_id Problem.not_found: allOf: - $ref: '#/components/schemas/Problem' description: >- Not found. Check the id, and check that the account you call with owns the resource. properties: type: const: https://developers.investorlift.com/marketplace/errors#not_found title: const: Not found status: const: 404 code: const: not_found recovery: const: >- Check the id, and check that the account you call with owns the resource. Problem.method_not_allowed: allOf: - $ref: '#/components/schemas/Problem' description: >- Method not allowed. Use one of the methods the documentation lists for this path. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#method_not_allowed title: const: Method not allowed status: const: 405 code: const: method_not_allowed recovery: const: Use one of the methods the documentation lists for this path. Problem.deal_closed: allOf: - $ref: '#/components/schemas/Problem' description: >- Deal closed. Read the deal to see the current status, and act on an open deal instead. properties: type: const: https://developers.investorlift.com/marketplace/errors#deal_closed title: const: Deal closed status: const: 409 code: const: deal_closed recovery: const: >- Read the deal to see the current status, and act on an open deal instead. Problem.offer_superseded: allOf: - $ref: '#/components/schemas/Problem' description: >- Round closed. Read the id of the open round in the body, then act on that round. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#offer_superseded title: const: Round closed status: const: 409 code: const: offer_superseded recovery: const: Read the id of the open round in the body, then act on that round. Problem.wrong_side: allOf: - $ref: '#/components/schemas/Problem' description: >- Other side acts next. Wait for the counterparty to answer, because the current round belongs to them. properties: type: const: https://developers.investorlift.com/marketplace/errors#wrong_side title: const: Other side acts next status: const: 409 code: const: wrong_side recovery: const: >- Wait for the counterparty to answer, because the current round belongs to them. Problem.validation_failed: allOf: - $ref: '#/components/schemas/Problem' description: >- Body failed validation. Correct each field the detail names, then repeat the call. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#validation_failed title: const: Body failed validation status: const: 422 code: const: validation_failed recovery: const: Correct each field the detail names, then repeat the call. Problem.cap_reached: allOf: - $ref: '#/components/schemas/Problem' description: >- Cap reached. Wait for the time in Retry-After, or raise your trust tier with the step in GET /me. properties: type: const: https://developers.investorlift.com/marketplace/errors#cap_reached title: const: Cap reached status: const: 429 code: const: cap_reached recovery: const: >- Wait for the time in Retry-After, or raise your trust tier with the step in GET /me. Problem.daily_cap_reached: allOf: - $ref: '#/components/schemas/Problem' description: >- Daily cap reached. Wait for the next day in UTC, or raise your trust tier with the step in GET /me. properties: type: const: >- https://developers.investorlift.com/marketplace/errors#daily_cap_reached title: const: Daily cap reached status: const: 429 code: const: daily_cap_reached recovery: const: >- Wait for the next day in UTC, or raise your trust tier with the step in GET /me. Problem.origin_error: allOf: - $ref: '#/components/schemas/Problem' description: >- Service unavailable. Repeat the call in a minute, and tell Investorlift support when the answer stays the same. properties: type: const: https://developers.investorlift.com/marketplace/errors#origin_error title: const: Service unavailable status: const: 503 code: const: origin_error recovery: const: >- Repeat the call in a minute, and tell Investorlift support when the answer stays the same. Problem: type: object description: >- One refusal, as RFC 9457 application/problem+json. The code picks the status, the title and the recovery sentence. properties: type: type: string format: uri description: The errors page anchor of the code. title: type: string description: The short title of the code. status: type: integer description: The HTTP status of this answer. code: type: string enum: - address_unavailable - agreement_required - api_offers_disabled - below_floor - cap_reached - client_limit - daily_cap_reached - deal_changed - deal_closed - deal_incomplete - designation_required - draft_under_review - duplicate_inquiry - forbidden - idempotency_conflict - idempotency_in_progress - idv_required - insufficient_balance - insufficient_role - insufficient_scope - invalid_body - invalid_id - invalid_parameter - invalid_transition - lead_locked - method_not_allowed - no_organization - not_a_member - not_found - offer_exists - offer_required - offer_superseded - organization_required - origin_error - person_exists - preview_expired - preview_mismatch - proof_of_funds_expired - proof_of_funds_missing - rate_limited - requirement_unmet - resource_exists - resource_limit - strike_exists - strike_window_closed - terms_required - unauthorized - unknown_parameter - validation_failed - webhook_limit - webhook_url_refused - wrong_side description: The problem code. Read this, never the title. detail: type: string description: What happened for this one request. recovery: type: string description: One sentence that says what to do next. request_id: type: string description: The id this answer shares with the log. required: - type - title - status - code - detail - recovery - request_id securitySchemes: oauth2: type: oauth2 description: >- Authorization code with PKCE. The person grants the scopes on the Investorlift consent page and accepts the Marketplace API Terms there. flows: authorizationCode: authorizationUrl: https://mogul.investorlift.com/api/auth/oauth2/authorize tokenUrl: https://mogul.investorlift.com/api/auth/oauth2/token refreshUrl: https://mogul.investorlift.com/api/auth/oauth2/token scopes: marketplace:profile: Read your account, your organization and your trust tier. deals:read: Read your deals as a seller, and the deals you see as a buyer. deals:write: >- Create drafts, add media and documents, publish deals and change their status. offers:read: >- Read the offers on your deals as a seller, and your own offers as a buyer. offers:write: Make, counter, accept, decline and withdraw offers. inquiries:read: >- Read the inquiries and address requests on your deals, and your own. inquiries:write: Send inquiries and address requests, and answer address requests. leads:read: Read the leads on your deals with their history. leads:write: Set a lead status, add a lead and file a strike. contacts:read: >- Read the email address and the phone number of a buyer on your deals. reviews:read: Read a seller public profile and the reviews of that seller. buy_boxes:manage: Read and change your buy boxes and their alerts. webhooks:manage: Create, read and delete the webhook endpoints of your side. events:read: Read the event feed of your side. ```` ## Related topics - [Preview an answer to an open round](/api-reference/buy/preview-an-answer-to-an-open-round.md) - [Counter the seller round](/api-reference/buy/counter-the-seller-round.md) - [Accept the seller round](/api-reference/buy/accept-the-seller-round.md) - [Counter an offer on your deal](/api-reference/sell/counter-an-offer-on-your-deal.md)