Agent Quickstart - Easy Street Offers

Make your first request for cash offers

To make your first test request for cash offers, you can make a POST request to the /offer-requests endpoint in the playground or with cURL:

curl --request POST \
  --url https://v2.easystreetoffers.com/api/v2/offer-requests \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request": {
    "offer_request_asking": 3900000,
    "test": true
  },
  "property": {
    "StreetNumber": "123",
    "StreetName": "Easy St",
    "City": "Easy",
    "StateOrProvince": "CA",
    "PostalCode": "12345",
    "UnitNumber": "1",
    "Stories": 1,
    "BedroomsTotal": 3,
    "BathroomsFull": 3,
    "BathroomsHalf": 0,
    "YearBuilt": 1951,
    "Longitude": -121.999418,
    "Latitude": 37.8450264,
    "LivingArea": 2400,
    "ListPrice": 2654000,
    "MlsStatus": "Off-market",
    "Notes": "",
    "Sewer": [
      "Public Sewer"
    ],
    "SpaYN": false,
    "GarageYN": true,
    "CarportYN": false,
    "BasementYN": false,
    "WaterSource": [
      "Public"
    ],
    "GarageSpaces": 1,
    "OccupantType": "Owner",
    "OtherParking": "Attached",
    "AssociationYN": true,
    "OpenParkingYN": false,
    "PoolPrivateYN": false,
    "AssociationFee": 0,
    "StandardStatus": "Off Market",
    "LivingAreaUnits": "Square Feet",
    "PropertySubType": "Single Family Residence",
    "AttachedGarageYN": false,
    "LotSizeSquareFeet": 21000,
    "SeniorCommunityYN": false,
    "inventory_password": 573923,
    "PowerProductionType": "",
    "ConstructionMaterials": [
      "Wood Framing"
    ],
    "AssociationFeeFrequency": "Monthly"
  },
  "media": [
    "https://picsum.photos/200",
  ]
}'

Fields named with Pascal Case convention follow the RESO 2.0 standard. Please reference the Wiki before inquiring about field definitions

If successful, you will receive the following response:

{
  "offer_request_id": 888,
  "requested_by_agent": "8cedea14-8888-8888-8888-c8a782db0480",
  "inventory_property_id": 844,
  "offer_requested_at": "2024-06-24T15:30:52.755574+00:00",
  "offer_requested_decided_by": null,
  "offer_request_is_mls": null,
  "offer_request_deal_type": null,
  "offer_request_asking": 3900000,
  "offer_request_expires_at": null,
  "offer_request_is_approved": null,
  "offer_request_decided_at": null,
  "offer_request_viewed_at": null,
  "offer_request_status": "in_review",
  "offer_request_refreshed_at": null,
  "test": true,
  "submitted_by_user": "e83d3b1f-8888-8888-8888-9046049b8e2e"
}

You’ve just submitted your first Cash Offer Request! You can use the offer_request_id to identify it in your system & view the current status of your request.

Preliminary Request

Not ready to submit a full request yet? You can also check out how many buyers and buy boxes a property matches by hitting the preliminary request endpoint:

curl --location 'https://v2.easystreetoffers.com/api/v2/offer-requests/prelim' \
--header 'Content-Type: application/json' \
--header 'Authorization: <api-key>' \
--data '{
    "inventory": {
        "StateOrProvince": "CA",
        "PostalCode":"94507",
        "BedroomsTotal": 3,
        "BathroomsFull": 2,
        "LivingArea": 2650,
        "LotSizeSquareFeet": 6000,
        "ParkingTotal": 2,
        "YearBuilt": 1990,
        "ListPrice": 250000,
        "OccupantType": "Owner",
        "PoolPrivateYN": false,
        "StandardStatus": "Off-market"
    }
}'

Receiving notifications

By default, we send out email notifications to the ListAgentEmail for when offer requests are approved to be sent to buyers, and when offers are made on your requests.

If you leave out the ListAgentEmail or set it as null in your request API call, then the email notifications for the offer request will be sent to the email used to set up the API

Additionally, you can set up a webhook to receive notifications on key events related to your offer requests by posting to the /wh endpoint:

curl --request POST \
  --url https://v2.easystreetoffers.com/api/v2/wh \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com/webhook"
}'

When an offer request is approved, we’ll send a POST request to the webhook URL you provided with the following JSON body:

{
  "event": "offer_request_approved",
  "offer_request_id": 888,
  "offer_request_status": "receiving_offers"
}

When an offer is made on your request, we’ll send a POST request to the webhook URL you provided with the following JSON body:

{
  "event": "new_offer",
  "offer_id": 888,
  "offer_request_id": 888,
  "created_at": "2024-08-16T14:39:40.868004+00:00",
  "offer_amount": 500000,
  "buyer_pays_buyer_broker_commission": false,
  "buyer_pays_listing_broker_commission": false,
  "buyer_broker_commission_pct": 3,
  "listing_broker_commission_pct": 3,
  "offer_expires": "2024-08-18T14:39:32.806+00:00",
  "offer_memo": "",
  "offer_status": "active",
  "additional_terms": null,
  "earnest_money": 0,
  "em_hard_post_inspection": false,
  "lease_back": false,
  "lease_back_period": 0,
  "flexible_closing": false,
  "post_possession": false,
  "waive_warranty": false,
  "inspection_period": 10,
  "post_possession_period": 0,
  "offer_is_counter_offer": null,
  "offer_decided_at": null,
  "test": null,
  "viewed": false,
  "external_id": null,
  "offer_feedback": null,
  "offer_request_external_id": null
}

In the offer above, the offer_request_id is the same as the offer_request_id in the response from the /offer_requests endpoint. If you provided a offer_request_external_id, that gets returned as well. You can use that to identify the offer in your system. Now, let’s take a look at the offer itself. The buyer made an offer of $500,000 on your request. Because both buyer_pays_buyer_broker_commission and buyer_pays_listing_broker_commission are false, buyer has indicated that the offer assumes seller pays both buyer and listing broker commissions. Buyer broker commission goes to ESO, and is locked at 3%, while listing broker commission is variable. In the above transaction, seller is responsible for $500,000 * 3% = $15,000 in buyer broker commission, as well as $500,000 * 3% = $15,000 in listing broker commission. The seller is expected to net $470,000 before other closing costs from the transaction.

Responding to offers

At this point, you can do one of three things with the cash offer:

Accept it
Reject it
Counter it

We expect each broker to respond to offers on each property. Buyer has signed a binding buyer participation agreement with ESO, and by making the cash offer, has strong intent to close. We encourage agents to counter offers if they believe the initial offer falls outside of expected range, instead of rejecting. We hold both parties of the transaction accountable to being responsive.

Accepting an offer

You can accept an offer by sending a PATCH request to the /offers endpoint with offer_status as accepted:

curl --location --request PATCH 'https://v2.easystreetoffers.com/api/v2/offers/' \
--header 'Content-Type: application/json' \
--header 'Authorization: <key>' \
--data '{
    "offer_id": 888,
    "offer_status": "accepted"
}'

Once you accept an offer, our acquisitions team will be notified and reach out to you with next steps.

Once you accept one offer, all of the other offers and counter offers you made will be rejected.

Rejecting an offer

You can reject an offer by sending a PATCH request to the /offers endpoint with offer_status as rejected:

curl --location --request PATCH 'https://v2.easystreetoffers.com/api/v2/offers/' \
--header 'Content-Type: application/json' \
--header 'Authorization: <key>' \
--data '{
    "offer_id": 88,
    "offer_status": "rejected"
}'

Countering offers

If you have an offer that you’d like to counter, you can do so by posting to the /counter-offers endpoint:

curl --request POST \
  --url https://v2.easystreetoffers.com/api/v2/counter-offers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "offer_id": 123,
  "counter_offer_amount": 500000,
  "buyer_pays_buyer_broker_commission": true,
  "buyer_pays_listing_broker_commission": true,
  "listing_broker_commission_pct": 2,
  "counter_offer_memo": "<string>",
  "counter_offer_expires": "<string>",
  "counter_offer_terms": {},
  "counter_offer_status": "<string>",
  "counter_earnest_money": 123,
  "counter_em_hard_post_inspection": true,
  "counter_lease_back": true,
  "counter_lease_back_period": 123,
  "counter_flexible_closing": true,
  "counter_post_possession": true,
  "counter_waive_warranty": true,
  "counter_inspection_period": 123,
  "counter_post_possession_period": 123,
  "test": true
}'

In the counter offer above, you indicate that the seller is willing to accept a counter offer of $500,000, if the buyer agrees to paying the commissions. You have also adjusted the listing_broker_commission_pct to 2.0%, demonstrating your intent as listing broker to surrender 1% of the the offer amount to the buyer. If the buyer accepts this counter offer, the expected net cost to buyer is $500,000 * (100% + 3% + 2%) = $525,000 before other closing & reno costs. If the buyer accepts this counter offer, a new offer with status of accepted will be created, and your endpoint will get the same webhook as normal. If the buyer rejects this counter offer, you will get an UPDATE call to your callback.

If the buyer accepts your counter offer, we will reject all other offers made on your offer request. Only use a counter offer if you are prepared for the buyer to accept it.

Viewing all your cash offers

You can view the cash offers on your requests by getting the /offers endpoint:

curl --request GET \
  --url https://v2.easystreetoffers.com/api/v2/offers \
  --header 'Authorization: <api-key>'

Returning

[
  {
    "offer_id": 888,
    "offer_request_id": 188,
    "offer_amount": 3800000,
    "buyer_pays_buyer_broker_commission": false,
    "buyer_pays_listing_broker_commission": false,
    "buyer_broker_commission_pct": 3,
    "buyer_broker_commission_amt": 15000,
    "listing_broker_commission_pct": 2,
    "listing_broker_commission_amt": 10000,
    "created_at": "2024-05-18T00:27:44.993+00:00",
    "offer_expires": "2024-05-18T00:21:50.714+00:00",
    "offer_memo": "",
    "offer_status": "active",
    "additional_terms": null,
    "earnest_money": 0,
    "em_hard_post_inspection": false,
    "lease_back": false,
    "lease_back_period": 0,
    "flexible_closing": false,
    "post_possession": false,
    "waive_warranty": false,
    "inspection_period": 10,
    "post_possession_period": 0,
    "offer_is_counter_offer": null,
    "offer_decided_at": null,
    "test": null
  },
  ...
]

Adding pictures after submission

After submission, you can add pictures to the offer request by sending a PATCH request to the /offer-requests endpoint.

curl --location --request PATCH 'https://v2.easystreetoffers.com/api/v2/offer-requests/' \
--header 'Content-Type: application/json' \
--header 'Authorization: <key>' \
--data '{ 
    "offer_request_id": 888,
    "media": [
        "https://picsum.photos/200",
        "https://picsum.photos/200"
    ]
}'

Next Steps

That’s it! Go to our API playground to explore all the options and features.

​Make your first request for cash offers

​Preliminary Request

​Receiving notifications

​Responding to offers

​Accepting an offer

​Rejecting an offer

​Countering offers

​Viewing all your cash offers

​Adding pictures after submission

​Next Steps

Make your first request for cash offers

Preliminary Request

Receiving notifications

Responding to offers

Accepting an offer

Rejecting an offer

Countering offers

Viewing all your cash offers

Adding pictures after submission

Next Steps