{"openapi":"3.1.0","info":{"title":"Seb's List API","version":"1.0.0","description":"Verified, first-party rental listings for AI agents. Every listing comes directly from a verified broker or property manager and carries freshness and field-level provenance.","contact":{"name":"Seb's List","url":"https://sebslist.com","email":"developers@sebslist.com"}},"servers":[{"url":"https://api.sebslist.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key: sl_live_…"}},"schemas":{"Problem":{"type":"object","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"request_id":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}},"RentalListing":{"type":"object","properties":{"id":{"type":"string","description":"Stable listing id, e.g. rnt_01JB8X3F6Q9W2C4M7K5T0V8N1D"},"object":{"type":"string","const":"rental_listing"},"status":{"type":"string","enum":["active","pending","off_market","rented","expired","removed"]},"headline":{"type":"string"},"freshness":{"type":"object","properties":{"state":{"type":"string","enum":["fresh","stale","expired"]},"last_verified_at":{"type":"string"},"verified_via":{"type":"string","enum":["intake","checkin","source_sync","feed","admin"]}},"required":["state","last_verified_at","verified_via"],"additionalProperties":false},"address":{"type":"object","properties":{"street":{"type":"string"},"unit":{"type":["string","null"]},"neighborhood":{"type":["string","null"]},"borough":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]}},"required":["street","unit","neighborhood","borough","city","state","postal_code","lat","lng"],"additionalProperties":false},"rent":{"type":"object","properties":{"monthly":{"type":["number","null"]},"currency":{"type":"string"},"net_effective":{"type":["number","null"]},"concessions":{"anyOf":[{"type":"object","properties":{"months_free":{"type":["number","null"]},"on_lease_months":{"type":["number","null"]},"notes":{"type":["string","null"]}},"required":["months_free","on_lease_months","notes"],"additionalProperties":false},{"type":"null"}]}},"required":["monthly","currency","net_effective","concessions"],"additionalProperties":false},"fees":{"type":"object","properties":{"no_fee":{"type":["boolean","null"]},"broker_fee":{"anyOf":[{"type":"object","properties":{"amount":{"type":["number","null"]},"percent_of_annual_rent":{"type":["number","null"]},"paid_by":{"type":"string","enum":["tenant","landlord","none","unknown"]}},"required":["amount","percent_of_annual_rent","paid_by"],"additionalProperties":false},{"type":"null"}]},"application":{"type":["number","null"]},"amenity_monthly":{"type":["number","null"]},"move_in":{"type":["number","null"]},"security_deposit":{"type":["number","null"]},"other":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"amount":{"type":"number"},"recurring":{"type":"boolean"}},"required":["name","amount","recurring"],"additionalProperties":false}}},"required":["no_fee","broker_fee","application","amenity_monthly","move_in","security_deposit","other"],"additionalProperties":false},"layout":{"type":"object","properties":{"bedrooms":{"type":["number","null"]},"bathrooms":{"type":["number","null"]},"square_feet":{"type":["number","null"]},"floor":{"type":["number","null"]}},"required":["bedrooms","bathrooms","square_feet","floor"],"additionalProperties":false},"available_from":{"type":["string","null"]},"lease_terms_months":{"type":"array","items":{"type":"number"}},"pets":{"type":"object","properties":{"cats":{"type":["boolean","null"]},"dogs":{"type":["boolean","null"]},"max_weight_lbs":{"type":["number","null"]},"breed_restrictions":{"type":["boolean","null"]},"pet_rent_monthly":{"type":["number","null"]},"pet_deposit":{"type":["number","null"]},"notes":{"type":["string","null"]}},"required":["cats","dogs","max_weight_lbs","breed_restrictions","pet_rent_monthly","pet_deposit","notes"],"additionalProperties":false},"laundry":{"type":["string","null"]},"amenities":{"type":"array","items":{"type":"string"}},"building_amenities":{"type":"array","items":{"type":"string"}},"outdoor_space":{"type":"array","items":{"type":"string"}},"furnished":{"type":["boolean","null"]},"utilities_included":{"type":"array","items":{"type":"string"}},"requirements":{"type":"object","properties":{"income":{"type":["string","null"]},"guarantor":{"type":["string","null"]}},"required":["income","guarantor"],"additionalProperties":false},"rent_stabilized":{"type":["boolean","null"]},"tours":{"type":"object","properties":{"in_person":{"type":["boolean","null"]},"virtual":{"type":["boolean","null"]},"self_guided":{"type":["boolean","null"]},"booking_url":{"type":["string","null"]},"notes":{"type":["string","null"]}},"required":["in_person","virtual","self_guided","booking_url","notes"],"additionalProperties":false},"supplier":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["brokerage","property_manager","landlord","other"]},"verified":{"type":"boolean"}},"required":["id","name","kind","verified"],"additionalProperties":false},"contact":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["name","email","phone","url"],"additionalProperties":false,"description":"How the renter (or agent) should reach the supplier. Seb's List does not intermediate."},"supplier_url":{"description":"The supplier's own page for this unit, when available.","type":["string","null"]},"provenance":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["supplier_reported","public_record","derived"]},"description":"Where each field's value came from."},"distance_meters":{"type":["number","null"]}},"required":["id","object","status","headline","freshness","address","rent","fees","layout","available_from","lease_terms_months","pets","laundry","amenities","building_amenities","outdoor_space","furnished","utilities_included","requirements","rent_stabilized","tours","supplier","contact","supplier_url","provenance"],"additionalProperties":false},"RentalContact":{"type":"object","properties":{"object":{"type":"string","const":"rental_contact"},"listing_id":{"type":"string"},"referral_id":{"type":"string"},"supplier":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"verified":{"type":"boolean"}},"required":["id","name","verified"],"additionalProperties":false},"contact":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["name","email","phone","url"],"additionalProperties":false},"supplier_url":{"description":"The supplier's own listing page, tagged for attribution.","type":["string","null"]},"instructions":{"type":"string"}},"required":["object","listing_id","referral_id","supplier","contact","supplier_url","instructions"],"additionalProperties":false},"Markets":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"}},"required":["id","name","timezone"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}},"paths":{"/v1/rentals/search":{"get":{"operationId":"searchRentals","summary":"Search available rentals","parameters":[{"name":"market","in":"query","required":false,"schema":{"default":"nyc","type":"string"}},{"name":"bedrooms_min","in":"query","required":false,"description":"0 = studio","schema":{"description":"0 = studio","type":"number","minimum":0}},{"name":"bedrooms_max","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"bathrooms_min","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"rent_min","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"rent_max","in":"query","required":false,"schema":{"type":"number","minimum":0}},{"name":"neighborhoods","in":"query","required":false,"description":"e.g. 'East Village,Williamsburg'","schema":{"description":"e.g. 'East Village,Williamsburg'","type":"array","items":{"type":"string"}}},{"name":"boroughs","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["Manhattan","Brooklyn","Queens","Bronx","Staten Island"]}}},{"name":"near_lat","in":"query","required":false,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"near_lng","in":"query","required":false,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radius_meters","in":"query","required":false,"schema":{"default":1500,"type":"number","minimum":100,"maximum":25000}},{"name":"pets","in":"query","required":false,"schema":{"type":"string","enum":["dogs","cats","any"]}},{"name":"no_fee","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"laundry_in_unit","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"furnished","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"amenities","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["dishwasher","washer_dryer_in_unit","central_air","air_conditioning","hardwood_floors","high_ceilings","exposed_brick","fireplace","walk_in_closet","renovated_kitchen","stainless_appliances","microwave","home_office","storage_in_unit","city_view","water_view","doorman","full_time_doorman","virtual_doorman","elevator","laundry_in_building","gym","pool","roof_deck","garden","courtyard","bike_room","storage","parking","garage","package_room","concierge","live_in_super","lounge","coworking","playroom","pet_spa","wheelchair_accessible","smoke_free"]}}},{"name":"available_by","in":"query","required":false,"description":"Units available on or before this date (YYYY-MM-DD).","schema":{"description":"Units available on or before this date (YYYY-MM-DD).","type":"string","format":"date","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])))$"}},{"name":"max_age_days","in":"query","required":false,"description":"Only listings confirmed within this many days.","schema":{"default":7,"description":"Only listings confirmed within this many days.","type":"number","minimum":1,"maximum":21}},{"name":"sort","in":"query","required":false,"schema":{"default":"newest","type":"string","enum":["newest","rent_asc","rent_desc","distance"]}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A page of listings","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/RentalListing"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}}}}}},"400":{"description":"Invalid query","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Missing or invalid credentials","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/rentals/{id}":{"get":{"operationId":"getRental","summary":"Get one listing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^rnt_[0-9A-Z]{26}$"}}],"responses":{"200":{"description":"Listing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalListing"}}}},"401":{"description":"Missing or invalid credentials","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/rentals/{id}/contact":{"post":{"operationId":"contactSupplier","summary":"Get the supplier's contact details for a listing (records a referral)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Contact","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RentalContact"}}}},"401":{"description":"Missing or invalid credentials","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/markets":{"get":{"operationId":"listMarkets","summary":"Covered markets","responses":{"200":{"description":"Markets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Markets"}}}},"401":{"description":"Missing or invalid credentials","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}}}