{"openapi":"3.1.0","info":{"title":"Replicly API","version":"1.0.0","description":"Buffett-inspired research on US-listed companies: deterministic tests and valuation from SEC filings, plus full evidence-quoted analyses. Research, not advice."},"servers":[{"url":"https://www.replicly.com"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A Max plan key (rep_sk_...) or the public sandbox key rep_sandbox_public."}},"schemas":{"Meta":{"type":"object","properties":{"disclaimer":{"type":"string"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}},"paths":{"/api/v1/companies/search":{"get":{"operationId":"search_company","summary":"Search US-listed companies","description":"Find companies by ticker or name. Returns up to 10 matches with ticker, CIK and exchange.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"description":"Ticker or company name"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/companies/{ticker}/snapshot":{"get":{"operationId":"get_snapshot","summary":"Live Buffett tests and valuation","description":"Deterministic view of a company from SEC filings: ten-year metrics, Buffett's measurable tests, and a bear/base/bull intrinsic value range with sensitivity grid. No AI involved. With a user key, the margin of safety follows that user's lens.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":12,"description":"US ticker, e.g. KO, AAPL, BRK-B"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/companies/{ticker}/analysis":{"get":{"operationId":"get_company_analysis","summary":"Latest full analysis of a company","description":"The newest completed analysis: business, moat, management, case against (all quoted from the 10-K), tests, valuation and verdict. Returns your own latest analysis with a user key, otherwise the public house analysis if one exists.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":12,"description":"US ticker, e.g. KO, AAPL, BRK-B"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/analyses":{"post":{"operationId":"run_analysis","summary":"Start a new analysis","description":"Queues a full Buffett-style analysis (two to four minutes). Returns a job id; poll get_analysis until status is succeeded. Counts against your monthly allowance. Send an Idempotency-Key header to make retries safe. Requires a Max plan key.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","minLength":1,"maxLength":12,"description":"US ticker, e.g. KO, AAPL, BRK-B"},"depth":{"default":"standard","type":"string","enum":["standard","deep"]}},"required":["ticker","depth"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/analyses/{id}":{"get":{"operationId":"get_analysis","summary":"Job status or finished analysis","description":"Pass a job id from run_analysis (or an analysis id). Returns progress while running, the full analysis when done, or the error if it failed.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/desk":{"get":{"operationId":"get_desk","summary":"The latest Desk edition","description":"Replicly's fortnightly shortlist: every US filer swept, Buffett's and Graham's screens run, survivors read and the best researched in full. Returns each company's rank, the screens it passed with every rule's actual value, the verdict of its full analysis and its margin of safety (re-priced nightly). The sandbox key sees the free top three.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/market":{"get":{"operationId":"get_market_context","summary":"Market-level context","description":"The 10-year Treasury yield, the Buffett indicator (US equities / GDP) with history, and GBP/USD.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/berkshire":{"get":{"operationId":"get_berkshire_holdings","summary":"Berkshire Hathaway 13F holdings","description":"Latest Form 13F positions with weights and share changes versus the prior quarter. Up to 45 days stale by design; includes positions chosen by Berkshire's other managers.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/pricing":{"get":{"operationId":"get_pricing","summary":"Plans, prices and limits","description":"Machine-readable plans with GBP prices and every entitlement.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"4XX":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}