OfferInput

The OfferInput type determines the input fields for an offer request as part of the OfferRequestUpdateInput. That includes contact details as well as home details.

OfferInput is an incremental input: no field inside it is required by the GraphQL schema. After both sellerFullName and sellerEmail have been provided through the API, additional OfferInput values may still be submitted, but they may not be considered for pricing. Partners should provide denial-capable home information when it is known, so Opendoor can stop an ineligible request before assessment. Other home and seller details are optional enrichment and should be sent when available.

Definition

input OfferInput {
  sellerEmail: String
  sellerFullName: String
  sellerPhoneNumber: String
  sellerRelationToOwner: String
  sellerRelationToOwnerOther: String
  sellerWorkingWithHomeBuilder: Boolean
  sellerSaleTimeline: String
  homeDwellingType: String
  homeBedrooms: Int
  homeBathroomsFull: Int
  homeBathroomsPartial: Int
  homeYearBuilt: Int
  homeExteriorStories: Int
  homeAboveGradeSqFt: Int
  homeCoveredParkingType: String
  homeGarageSpaces: Int
  homeCarportSpaces: Int
  homePoolType: String
  homeHasBasement: Boolean
  homeBasementFinishedSqFt: Int
  homeBasementUnfinishedSqFt: Int
  homeKitchenCounterType: String
  homeHoa: Boolean
  homeHoaTypeAgeRestrictedCommunity: Boolean
  homeHoaTypeGatedCommunity: Boolean
  homeHoaTypeGuardedGatedCommunity: Boolean
  homeEntryType: String
  homeEligibilityCriteriaLeasedSolarPanels: Boolean
  homeEligibilityCriteriaKnownFoundationIssues: Boolean
  homeEligibilityCriteriaFireDamage: Boolean
  homeEligibilityCriteriaWellWater: Boolean
  homeEligibilityCriteriaSeptic: Boolean
  homeEligibilityCriteriaAsbestosSiding: Boolean
  homeEligibilityCriteriaLivestock: Boolean
  homeEligibilityCriteriaMobileManufacturedHome: Boolean
  homeEligibilityCriteriaUniqueOwnershipStructure: Boolean
  homeEligibilityCriteriaBelowMarketRateOwnership: Boolean
  homeEligibilityCriteriaRentControlledTenantOccupied: Boolean
  homeEligibilityCriteriaUndergroundOilTank: Boolean
  homeEligibilityCriteriaCesspool: Boolean
  homeKitchenCondition: String
  homeBathroomCondition: String
  homeLivingRoomCondition: String
  homeExteriorCondition: String
  homeHoaFees: Float
  homeHasUpgrades: Boolean
  sellerSmsOptIn: Boolean
  signedListingAgreement: Boolean
  listingAgentFullName: String
  listingAgentEmail: String
  listingAgentPhoneNumber: String
  correlationId: String
  experimental: [ExperimentalQuestionAnswerInput!]
}

Fields

Field	Type	Description
sellerEmail	String	Email address of the customer
sellerFullName	String	Full name of the customer
sellerPhoneNumber	String	Phone number of the customer. Supplied strings must be valid direct phone numbers without extensions and are normalized to E.164. Invalid values return BAD_USER_INPUT. Omit to leave unchanged; null clears the answer.
sellerRelationToOwner	String	Customer’s relationship to the homeowner, one of SELF, AGENT, AGENT_AND_OWNER, or OTHER. When OTHER, pair with sellerRelationToOwnerOther to capture the free-text explanation. This field can be used to deny an offer.
sellerRelationToOwnerOther	String	Free-text description of the seller’s relationship to the home when sellerRelationToOwner is OTHER (e.g., “executor of the estate”, “co-trustee”, “power of attorney holder”). Set this only when sellerRelationToOwner is OTHER; the BFF forwards the value to reception-be verbatim, so behavior when it is set alongside any other relation value is unspecified.
sellerWorkingWithHomeBuilder	Boolean	Is the customer working with a homebuilder
sellerSaleTimeline	String	How soon the customer is looking to sell the home, one of ASAP, 2_TO_4_WEEKS, 4_TO_6_WEEKS, 6_PLUS_WEEKS, JUST_BROWSING. This field can be used to deny an offer.
homeDwellingType	String	The type of dwelling that best describes the home, one of SINGLE_FAMILY, TOWNHOUSE, APARTMENT, MOBILE_HOME. For condos, use APARTMENT. This field can be used to deny an offer.
homeBedrooms	Int	Number of bedrooms in the home. This field can be used to deny an offer.
homeBathroomsFull	Int	Number of full bathrooms of the home
homeBathroomsPartial	Int	Number of partial bathrooms of the home
homeYearBuilt	Int	Year the home was built. This field can be used to deny an offer.
homeExteriorStories	Int	Number of floors, excluding basement
homeAboveGradeSqFt	Int	Square footage of the home
homeCoveredParkingType	String	Covered parking type of the home. If exists, one of GARAGE, CARPORT, BOTH, NONE
homeGarageSpaces	Int	Number of covered garage spaces of the home
homeCarportSpaces	Int	Number of covered carport spaces of the home
homePoolType	String	Pool type of the home, one of IN_GROUND, ABOVE_GROUND, COMMUNITY_POOL, NO_POOL. This field can be used to deny an offer.
homeHasBasement	Boolean	Whether the home has a basement
homeBasementFinishedSqFt	Int	Finished square footage of basement if the home has a basement
homeBasementUnfinishedSqFt	Int	Unfinished square footage of basement if the home has a basement
homeKitchenCounterType	String	Countertop of the kitchen in the home, one of FORMICA, CORIAN, SOLID_STONE_SLAB, GRANITE_TILE, OTHER_TILE
homeHoa	Boolean	Is the home part of a home owner’s association (HOA)
homeHoaTypeAgeRestrictedCommunity	Boolean	If the home has a HOA, whether it belongs to an age-restricted community. This field can be used to deny an offer.
homeHoaTypeGatedCommunity	Boolean	If the home has a HOA, whether it belongs to a gated community. This field can be used to deny an offer.
homeHoaTypeGuardedGatedCommunity	Boolean	If the home has a HOA and belongs to a gated community, whether there is a guard at the entrance. This field can be used to deny an offer.
homeEntryType	String	For apartments / condos, how to best enter the home. One of DIRECT_ENTRY, SHARED_ENTRANCE_CONDO. Choose SHARED_ENTRANCE_CONDO if entry is via a lobby or foyer, and DIRECT_ENTRY if there is direct entry from the outside to the home. This field can be used to deny an offer.
homeEligibilityCriteriaLeasedSolarPanels	Boolean	The home has leased or financed solar panels. This field can be used to deny an offer.
homeEligibilityCriteriaKnownFoundationIssues	Boolean	The home has known foundation issues such as excessive cracking or uneven floors. This field can be used to deny an offer.
homeEligibilityCriteriaFireDamage	Boolean	The home has fire damage. This field can be used to deny an offer.
homeEligibilityCriteriaWellWater	Boolean	The home maintains a well to supply water. This field can be used to deny an offer.
homeEligibilityCriteriaSeptic	Boolean	The home has a septic system separate from municipal sewage. This field can be used to deny an offer.
homeEligibilityCriteriaAsbestosSiding	Boolean	The home has asbestos siding. This field can be used to deny an offer.
homeEligibilityCriteriaLivestock	Boolean	Livestock live on the property, such as horses. This field can be used to deny an offer.
homeEligibilityCriteriaMobileManufacturedHome	Boolean	The home is a mobile or manufactured home. This field can be used to deny an offer.
homeEligibilityCriteriaUniqueOwnershipStructure	Boolean	The home has a unique ownership structure, such as tenants in common or co-ops. This field can be used to deny an offer.
homeEligibilityCriteriaBelowMarketRateOwnership	Boolean	The home is part of a below-market-rate ownership program. This field can be used to deny an offer.
homeEligibilityCriteriaRentControlledTenantOccupied	Boolean	The home is rent controlled and has a tenant today. This field can be used to deny an offer.
homeEligibilityCriteriaUndergroundOilTank	Boolean	The home has existing active or inactive underground fuel oil tanks. This field can be used to deny an offer.
homeEligibilityCriteriaCesspool	Boolean	The home has a cesspool on the property.
homeKitchenCondition	String	Home kitchen condition as rated by the seller, one of FIXER_UPPER, DATED, STANDARD, HIGH_END, LUXURY.
homeBathroomCondition	String	Home bathroom condition as rated by the seller, one of FIXER_UPPER, DATED, STANDARD, HIGH_END, LUXURY.
homeLivingRoomCondition	String	Home living room condition as rated by the seller, one of FIXER_UPPER, DATED, STANDARD, HIGH_END, LUXURY.
homeExteriorCondition	String	Home exterior condition as rated by the seller, one of FIXER_UPPER, DATED, STANDARD, HIGH_END, LUXURY.
homeHoaFees	Float	—
homeHasUpgrades	Boolean	—
sellerSmsOptIn	Boolean	—
signedListingAgreement	Boolean	Whether the seller has a signed listing agreement with a real estate agent to sell the home.
listingAgentFullName	String	Full name of the seller’s listing agent. Provide when signedListingAgreement is true.
listingAgentEmail	String	Email address of the seller’s listing agent. Provide when signedListingAgreement is true.
listingAgentPhoneNumber	String	Phone number of the seller’s listing agent. Optional; provide when signedListingAgreement is true.
correlationId	String	—
experimental	[ExperimentalQuestionAnswerInput!]	Flexible experimental questions for partner-specific extensions.