Skip to main content
POST
/
offer-requests
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": {
    "UnparsedAddress": "123 Easy St, Easy, CA 12345",
    "ListAgentEmail": "Agent@gmail.com",
    "ListAgentFirstName": "First Name",
    "ListAgentLastName": "Last Name"
  },
  "media": [
    "https://picsum.photos/200"
  ]
}'
{
  "offer_request_asking": 123,
  "offer_request_status": "active",
  "offer_requested_at": "now()",
  "offer_requested_decided_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "offer_request_is_mls": true,
  "offer_request_deal_type": "<string>",
  "offer_request_expires_at": "<string>",
  "offer_request_is_approved": true,
  "offer_request_decided_at": "<string>",
  "offer_request_viewed_at": "<string>",
  "offer_request_refreshed_at": "<string>",
  "inventory_property_id": 123,
  "test": true
}

Authorizations

​
Authorization
string
header
required

Body

application/json

New offer request

​
request
object
​
property
object

property fields named with Pascal Case convention follow the RESO 2.0 standard

​
assumptions
object[]

Analyst assumptions. Only available to buyers

​
media
string[]

List of signed URLs. Note that the URLs will become invalid after 10 minutes.

Response

successful request

​
offer_request_asking
integer

Asking price for the property

​
offer_request_status
enum<string>

Offer request statuses:

  • in_submission - Offer request is incomplete.
  • initial_offer - Offer request has complete property details, and has received an instant preview offer, but not yet submitted to the marketplace.
  • active - Offer request is active in the marketplace and receiving cash offers.
  • expired - Offer request has expired and is ready to be renewed.
  • denied - Offer request does not meet our criteria, and has been denied.
  • under_contract - Offer request is currently under contract with a buyer.
  • closed - Offer request has successfully closed after previously being under_contract.
  • processing - Offer request is currently retrieving property data or buyer filtering is occurring.
Available options:
in_submission,
initial_offer,
active,
expired,
denied,
under_contract,
closed,
processing
Example:

"active"

​
offer_requested_at
string<timestamp with time zone>
default:now()

timestamp with time zone

​
offer_requested_decided_by
string<uuid>
​
offer_request_is_mls
boolean

Is the property for the offer request listed on MLS

​
offer_request_deal_type
string<text>
​
offer_request_expires_at
string<timestamp with time zone>

timestamp with time zone

​
offer_request_is_approved
boolean

Field is true after we have approved the offer request to be sent to buyers.

​
offer_request_decided_at
string<timestamp with time zone>

timestamp with time zone

​
offer_request_viewed_at
string<timestamp with time zone>

timestamp with time zone

​
offer_request_refreshed_at
string<timestamp with time zone>

timestamp with time zone

​
inventory_property_id
integer

Used to uniquely identify the property in our system. Can safely ignore

​
test
boolean

set to true s