{"openapi":"3.1.0","info":{"title":"VendorStacks API","version":"1.0.0","description":"Subprocessor disclosure data API for GTM workflows and AI agents: whether an entity publishes a subprocessor list, and the structured vendor stack extracted from it, with quoted evidence. Credit-metered; 402 responses carry a topup_url."},"servers":[{"url":"https://vendorradar-production.up.railway.app"}],"components":{"securitySchemes":{"api_key":{"type":"http","scheme":"bearer","description":"vr_live_… key from POST /v1/keys"}}},"paths":{"/v1/keys":{"post":{"summary":"Instant API key (25 free credits for new accounts)","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email"}}}}}},"responses":{"201":{"description":"Key issued — shown once"},"400":{"description":"Invalid email"},"429":{"description":"Daily per-IP limit"}}}},"/v1/check":{"get":{"summary":"Vendor stack for a domain — 1 credit flat (live-scans unindexed domains automatically)","security":[{"api_key":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"refresh","in":"query","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"Vendor stack + evidence"},"402":{"description":"Credits exhausted — follow topup_url"},"502":{"description":"Fresh scan failed (charged 0)"}}}},"/v1/company/{domain}":{"get":{"summary":"Profile read, never triggers a scan (1cr)","security":[{"api_key":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cached record or known:false"}}}},"/v1/prospect":{"get":{"summary":"Reverse lookup: companies using a vendor/category (1cr per page of 10)","security":[{"api_key":[]}],"parameters":[{"name":"vendor","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"segment","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Paged companies with evidence"}}}},"/v1/balance":{"get":{"summary":"Credit balance","security":[{"api_key":[]}],"responses":{"200":{"description":"Balance"}}}},"/v1/pricing":{"get":{"summary":"Pricing (JSON)","responses":{"200":{"description":"Prices, packs, topup_url"}}}},"/v1/vendors":{"get":{"summary":"Vendor dictionary by category","responses":{"200":{"description":"Categories"}}}}}}