API Dashboard

Taffy 3.1.0

Resources:

tenants DELETE PATCH PUT POST GET /tenants

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns a tenant's (client's) representation registration status by email address: whether an agreement is signed, the signing agent, the sign date, a derived expiration, cell phone and any declared co-signer. Lease history is at /leases
get
required string apiKey (default: "")
API KEY
optional string email (default: "")
Email address of the tenant, or a comma-delimited list of email addresses. Required unless id is provided. Note that one email can match several contact records, which are returned separately.
optional string id (default: "")
ID number of an individual tenant (contact), or a comma-delimited list of ID numbers. Required unless email is provided.
optional numeric limit (default: 20)
Provide number of tenants per page (max 100)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional numeric agreement_term_days (default: 120)
Term length in days used to derive REPRESENTATION.EXPIRATION_DATE from the signing date. No expiration is stored in the database, so the returned date is always flagged EXPIRATION_IS_DERIVED and is an approximation.

neighborhoods DELETE PATCH PUT POST GET /neighborhoods

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns list of neighborhoods
get
required string apiKey (default: "")
API KEY
optional string neighborhood_id (default: "")
ID number of an indivisual neighborhood id, or a comma-delimited list of ID numbers

listingsHistory DELETE PATCH PUT POST GET /listingsHistory

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns list of listingsHistory
get
required string apiKey (default: "")
API KEY
required string listing_id (default: "")
ID number of an individual listing or a comma-delimited list of ID numbers.
optional numeric limit (default: 20)
Number of listings per result (5 / 10 / 20). Up to 100 listings per result
optional numeric page (default: 1)
Page number (1 or higher)
optional string update_type (default: "")
Status for status change or Price for price change
optional string updated_since (default: "")
Confine results to listing history which have benn updated since this time. Format MM/DD/YYYYTHH:MM, updated_since parameter only applies when update_type parameter is specified.
optional string status_type (default: "")
Filter status change logs based on new listing status type or price change log based on the current listing status

listings DELETE PATCH PUT POST GET /listings

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns list of listings
get
required string apiKey (default: "")
API KEY
optional numeric limit (default: 20)
Provide number of properties per page (10 / 20 / 40)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional string sort (default: date)
Provide sorting factor (price / size / date). Default sorting value is date update
optional string order (default: desc)
Provide sorting order (desc / asc)
optional string id (default: "")
ID number of an individual listing,or a comma-delimited list of ID numbers.
optional string status (default: 1,2)
Provide specific status id(s) [CSV] (Sales : 1, Rentals : 2, In Contract : 11, Offer In : 12, App. Pending : 21, Sold : 19, Rented : 22, Suspended : 0, Sales Inactive : -1, Rentals Inactive : -2, In Contract Inactive : -11, Offer In Inactive : -12, App. Pending Inactive : -21, Sold Inactive : -19, Rented Inactive : -22)
optional string updated_since (default: "")
Confine results to listings which have benn updated since this time. Format MM/DD/YYYYTHH:MM
optional string type (default: "")
Listing Building Type
optional string distribute (default: 0)
Public listings only set to 0 or to include Internal Listings set to -2
optional boolean internal (default: false)
Set to true to filter only internal listings (distribute values: 0, 3, -3, -2)
optional string neighborhood_id (default: "")
ID number of an indivisual category id (neighborhood id), or a comma-delimited list of ID numbers
optional numeric priceMin (default: 0)
Provide minimum price
optional numeric priceMax (default: 0)
Provide maximum price
optional numeric bedsMin (default: -1)
Provide minimum bedroom count
optional numeric bedsMax (default: -1)
Provide maximum bedroom count
optional numeric bathMin (default: 0)
Provide minimum bathroom count
optional numeric bathMax (default: 0)
Provide maximum bathroom count
optional boolean shortTerm (default: 0)
Brings only short term listings
optional numeric sortByCompanyID (default: 0)
Company internal CID to bring the company listing at first
optional boolean includeCoAgent (default: false)
True or False to include co-agent fileds or not
optional boolean includeContacts (default: false)
True or False to include contact records associated with listings. This option applies to company Databse only, no RLS DB nor MLS DB. Opne Listing DB (Listing Force) automtically includes contact records.
optional boolean includeDoc (default: false)
True or False to include document assigned on assocaited contact level
optional boolean includeLastOffmarketDate (default: 0)
include the last date when the listing becomes off market status
optional boolean addLabels (default: false)
Boolean value to include labels associated with each listing
optional string label (default: "")
Provide label name to search for
optional string rls_id (default: "")
Provide RLS ID
optional string mls_no (default: "")
Provide MLS No to search
optional string category (default: "")
Provide a category value or a list of the listing category values. (0: Open, 1: Semi-exclusive, 2: Exclusive, 4: Private 6: Co-Broke)
optional string amenities (default: "")
Provide amenities limitation [CSV] (Fireplace,Private Deck,Balcony,Terrace,Outdoor Space,Garden,Patio,Dining Room,Multi Level,Duplex,Triplex,Loft,Furnished,Dishwasher,Washer,Hardwood,High Ceilings,Renovated,Marble Bath,Granite Kitchen,Light,NO FEE,Vacation Rental,Eat In Kitchen,Walk In Closet,Laundry In Unit,Doorman,Elevator,Brownstone,Health Club,Pool,Garage,Subway,New Construction,Diplomats OK,Laundry,Bicycle Room,Storage,Nursery,Lounge,Valet,Roof Deck,Wheelchair Access,WiFi,Common Outdoor Space,Virtual Doorman,Receiving Room,Business Center,Green Building,River View,Park View,City View,Open View,Lake View,Freight Elevator,Concierge,Senior Housing,Live Work,Original Details,Skyline View,High Speed Internet,Maid Service,Live In Super,Children Playroom,Courtyard,Driveway,,Microwave,Stainless Steel Appliances,Pied a Terre,Room For Rent,Laundry Services,Wall to Wall Carpeting,One Month Free,Recreational Room,Convertible,Wine Cooler,Open Kitchen)
optional string address (default: "")
listing address to search for, API will return best matching results
optional string expand (default: "")
The list of expanded resource types you want included in the returned data. Curretnly expand supports agents and contacts. Agents return array of all agents associated with the listings.
optional boolean featured (default: false)
true or false to bring featured listings
optional numeric square_footage_min (default: 0)
Minimum Square Footage
optional string pets_policy (default: "")
List of pets option to search for (0: Unknown, 99: No Pets, 1: Cats Only,4: Dogs Only, 2: Small Pets, 3: Pets OK,98: Case By Case
optional string agent_email (default: "")
Search by agent email
optional string marketplace_name (default: "")
marketplace name from api_user table

leases DELETE PATCH PUT POST GET /leases

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns a tenant's signed lease history by email address: sign/start/end dates, address, beds/baths, monthly rent, agents and co-signers. Executed rentals only (Approved or Paid); Draft, Cancelled and Pending are excluded. Representation status is at /tenants
get
required string apiKey (default: "")
API KEY
optional string email (default: "")
Email address of the tenant, or a comma-delimited list of email addresses. Required unless id is provided. Returns the tenant's full signed lease history, newest first.
optional string id (default: "")
Contact ID of the tenant, or a comma-delimited list of ID numbers. Required unless email is provided.
optional numeric limit (default: 20)
Provide number of leases per page (max 100)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional string order (default: desc)
Sort order on lease sign date (desc / asc). Default desc, so the most recent signed lease is first.
optional string updated_since (default: "")
Confine results to leases signed on or after this time. Format mm/dd/yyyyThh:nn

leads DELETE PATCH PUT POST GET /leads

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns inbound leads and saved searches from the Alerts table, newest first: contact details, lead source, assigned agents, pipeline progress and the search criteria attached to the lead. Intended for CRM sync — poll with updated_since to pull only what changed. Note that this table holds both leads captured from listing sites and searches saved by hand, and no column reliably separates the two; see SOURCE, LISTING_ID and ALERT_NAME to classify.
get
required string apiKey (default: "")
API KEY
optional string id (default: "")
ID number of an individual lead, or a comma-delimited list of ID numbers.
optional string email (default: "")
Email address of the lead, or a comma-delimited list of email addresses. Note that email is not unique: the same address can appear on many unrelated leads, and is often an agent or placeholder address.
optional numeric limit (default: 20)
Provide number of leads per page (max 100)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional string sort (default: date)
Provide sorting factor (date / updated / id). date sorts on DATE_CREATE, updated on DATE_UPDATE.
optional string order (default: desc)
Provide sorting order (desc / asc). Default desc, so the newest lead is first.
optional string updated_since (default: "")
Confine results to leads changed on or after this time, compared against DATE_UPDATE. Use this to sync incrementally. Format mm/dd/yyyyThh:nn
optional string created_since (default: "")
Confine results to leads created on or after this time, compared against DATE_CREATE. Format mm/dd/yyyyThh:nn
optional string source (default: "")
Source ID, or a comma-delimited list of source IDs, as returned in SOURCE.ID. These IDs are defined per client database and are not portable between clients.
optional string agent_id (default: "")
Assigned agent ID, or a comma-delimited list. Matches a lead if the agent is any one of its assigned agents. Use 0 to return unassigned leads.
optional string status (default: "")
Filter on the alert active flag (1 = active, 0 = inactive). This flag controls whether the saved search still emails the client; it is NOT the lead pipeline stage, which is PROGRESS. Most historic rows are 0, so leave this empty unless you specifically want active alerts.
optional string lead_type (default: "")
Filter on lead type (sale / rent). Leads whose stored type is neither are returned only when this filter is empty; see LEAD_TYPE.

deals DELETE PATCH PUT POST GET /deals

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns list of deals
get
required string apiKey (default: "")
API KEY
optional numeric limit (default: 100)
Provide number of properties per page (10 / 20 / 40)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional string sort (default: date)
Provide sorting factor (id / date)
optional string order (default: desc)
Provide sorting order (desc / asc)
optional string id (default: "")
ID number of an individual deal ,or a comma-delimited list of ID numbers.
optional string updated_since (default: "")
Confine results to deals which have benn updated since this time. Format mm/dd/yyyyThh:nn

buildings DELETE PATCH PUT POST GET /buildings

+Query Params  +Accept  +Headers  +Basic Auth

Request Body:

Loading...

Response:

Returns list of buildings
get
required string apiKey (default: "")
API KEY
optional numeric limit (default: 20)
Provide number of properties per page (10 / 20 / 40)
optional numeric page (default: 1)
Provide page number (1 or higher)
optional string sort (default: date)
Provide sorting factor (id / date)
optional string order (default: desc)
Provide sorting order (desc / asc)
optional string id (default: "")
ID number of an individual listing,or a comma-delimited list of ID numbers.
optional string updated_since (default: "")
Confine results to buildings which have benn updated since this time. Format mm/dd/yyyyThh:nn
optional string type (default: "")
Building Type ()
optional string neighborhood_id (default: "")
ID number of an indivisual category id (neighborhood id), or a comma-delimited list of ID numbers
optional string expand (default: "")
Comma-separated list of related data to include (listings,contacts)
optional string featured (default: "")
Filter by featured flag (1 = featured, 0 = not featured)

Resources are listed in matching order. From top to bottom, the first URI to match the request is used.