{"openapi":"3.1.0","info":{"title":"rl.data.cool exchange API","version":"1.0.0","description":"Every action on rl.data.cool is available here. Reads are public at teaser level. Writes need an API key (Authorization: Bearer) with a role scope. Bids and buy-now from keys stay pending until the key owner confirms, unless within the key's spending cap."},"servers":[{"url":"https://rl.data.cool"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer"}},"schemas":{"Deal":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","pattern":"^(DC|L)-[0-9A-Z]{4}$"},"kind":{"type":"string","enum":["single","lot"]},"title":{"type":"string"},"status":{"type":"string","enum":["open","in_diligence","closed","expired"]},"listed":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Week the deal was listed (Monday)"},"vertical":{"type":"string","enum":["Legal & Professional","Healthcare","Finance & Insurance","Business Services","Construction & Field","Consumer Services","Commerce & Manufacturing","Software, Media & Marketing"]},"region":{"type":"string","enum":["US","Canada","UK","North America","International","Global"]},"headcount":{"type":"string","enum":["1-9","10-29","30-99","100-249","250+","1-29","30+","Any"]},"years":{"type":"string","enum":["Under 2","2-5","5-10","10+","Under 5","5+","Any"]},"units":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Number of businesses in the listing"},"closed_businesses":{"type":"integer","minimum":0,"maximum":9007199254740991},"systems":{"type":"array","items":{"type":"string","enum":["Email","Documents","Accounting","Chat","CRM","Call recordings","Industry software","Internal databases","Engineering","Application logs","Support desk","Commerce","Project management"]}},"volume":{"type":"string","enum":["Under 10k","10k-100k","100k-1M","1M-10M","10M+"],"description":"Approximate work pieces (emails, documents, tickets, records)"},"history":{"type":"string","enum":["1-3 years","3-5 years","5-10 years","10+ years","Unknown"]},"documentation":{"type":"string","enum":["Very well","Partially","Mostly undocumented","Unknown"]},"tier":{"type":"string","enum":["Exceptional","Strategic","Strong","Qualified"]},"score":{"type":"integer","minimum":0,"maximum":100},"rights":{"type":"object","properties":{"mandate":{"type":"string","enum":["verified","pending","n/a","failed"]},"pii":{"type":"string","enum":["verified","pending","n/a","failed"]},"privilege_screen":{"type":"string","enum":["verified","pending","n/a","failed"]},"registry":{"type":"string","enum":["verified","pending","n/a","failed"]}},"required":["mandate","pii","privilege_screen","registry"]},"verification":{"type":"object","properties":{"trust_score":{"type":"integer","minimum":0,"maximum":100},"chips":{"type":"array","items":{"type":"string"}}},"required":["trust_score","chips"]},"clean_room":{"type":"object","properties":{"provider":{"type":"string"},"recall":{"type":"number","minimum":0,"maximum":1},"report":{"type":"string","enum":["pending","available_under_nda"]}},"required":["provider","report"]},"license":{"type":"object","properties":{"type":{"type":"string","enum":["slots","exclusive","non_exclusive"]},"slots":{"type":"integer","minimum":1,"maximum":9007199254740991},"exclusive_window_available":{"type":"boolean"},"resale":{"type":"string"}},"required":["type","exclusive_window_available"]},"pricing":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"low":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Indicative low, whole deal"},"high":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Indicative high, whole deal"},"floor":{"description":"Minimum bid accepted","type":"integer","minimum":0,"maximum":9007199254740991},"buy_now":{"type":"integer","minimum":0,"maximum":9007199254740991},"bid_deadline":{"type":"string"}},"required":["currency","low","high"]},"source":{"type":"string","enum":["jottings","broker","data.cool"]},"teaser":{"type":"string"}},"required":["id","kind","title","status","listed","vertical","region","headcount","years","units","closed_businesses","systems","volume","history","documentation","tier","score","rights","license","pricing","source","teaser"]},"AccessRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"company":{"type":"string","maxLength":200},"deal_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string"}},"use_case":{"type":"string","maxLength":2000},"nda_signed_name":{"type":"string","minLength":1,"maxLength":200,"description":"Typed full name accepting the NDA"},"nda_accepted":{"type":"boolean","const":true,"description":"Must be true: accepts the rl.data.cool mutual NDA"}},"required":["name","email","deal_ids","nda_signed_name","nda_accepted"]},"Bid":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"company":{"type":"string","maxLength":200},"deal_id":{"type":"string"},"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Total bid in USD for the license"},"license":{"type":"string","enum":["slots","exclusive","non_exclusive"]},"notes":{"type":"string","maxLength":2000}},"required":["name","email","deal_id","amount"]},"BuyNow":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"company":{"type":"string","maxLength":200},"deal_id":{"type":"string"},"notes":{"type":"string","maxLength":2000}},"required":["name","email","deal_id"]},"Listing":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"company":{"type":"string","maxLength":200},"role":{"type":"string","enum":["owner","broker"]},"company_domain":{"type":"string","minLength":3,"maxLength":200},"mandate_url":{"description":"Link to signed mandate, or omit and upload later","type":"string","format":"uri"},"systems":{"minItems":1,"type":"array","items":{"type":"string","enum":["Email","Documents","Accounting","Chat","CRM","Call recordings","Industry software","Internal databases","Engineering","Application logs","Support desk","Commerce","Project management"]}},"headcount":{"type":"string","maxLength":40},"years":{"type":"string","maxLength":40},"volume":{"type":"string","maxLength":80},"notes":{"description":"Private, never published","type":"string","maxLength":4000}},"required":["name","email","role","company_domain","systems","headcount"]},"BuyOrder":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"company":{"type":"string","maxLength":200},"verticals":{"minItems":1,"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"min_volume":{"type":"string"},"systems":{"type":"array","items":{"type":"string"}},"budget_low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"budget_high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"details":{"type":"string","maxLength":4000}},"required":["name","email","verticals"]}}},"paths":{"/api/v1/deals":{"get":{"summary":"Search deals","parameters":[{"name":"q","in":"query","required":false,"description":"Free-text search over id, title, vertical, systems","schema":{"description":"Free-text search over id, title, vertical, systems","type":"string"}},{"name":"vertical","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"headcount","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"years","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"systems","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"tier","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"license","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Comma-separated list, same values as the website URL","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["single","lot"]}},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["score","price","listed","volume","id"]}},{"name":"dir","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"format","in":"query","schema":{"enum":["json","md"]}}],"responses":{"200":{"description":"Paged deals","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/deals/{id}":{"get":{"summary":"Get one deal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deal"}}}},"404":{"description":"Not found"}}}},"/d/{id}.md":{"get":{"summary":"Raw deal sheet (markdown + YAML frontmatter)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"text/markdown"}}}},"/api/v1/index":{"get":{"summary":"Price index by vertical","responses":{"200":{"description":"Index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/orders":{"get":{"summary":"Public buy orders","responses":{"200":{"description":"Orders","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"Post a buy order","security":[{"apiKey":["lab:bid"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyOrder"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/access-requests":{"post":{"summary":"Request access (accepts NDA by clickwrap)","security":[{"apiKey":["lab:read_private"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessRequest"}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/bids":{"post":{"summary":"Place a bid","security":[{"apiKey":["lab:bid"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bid"}}}},"responses":{"200":{"description":"Created, possibly pending_confirmation","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/buy-now":{"post":{"summary":"Buy now","security":[{"apiKey":["lab:bid"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyNow"}}}},"responses":{"200":{"description":"Created, possibly pending_confirmation","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/listings":{"post":{"summary":"Submit a listing (broker/owner intake, runs automated vetting)","security":[{"apiKey":["broker:list"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Listing"}}}},"responses":{"200":{"description":"Created with vetting results","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/listings/{id}":{"get":{"summary":"Listing status","security":[{"apiKey":["broker:list"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}