{"openapi":"3.1.0","info":{"title":"EverEnrich — Company & Contact Verification + Fit API","version":"0.1.0","description":"Pay-per-call US company & contact verification and fit scoring. Every answer is a typed decision (yes/no probability, score or choice) with evidence and the exact cost of producing it.","contact":{"name":"EverEnrich","url":"https://everenrich.fly.dev","email":"ianude@fanzyee.com"},"guidance":"Tiers (see GET /plans): Free = POST /verify/company, keyless and rate-limited, on open/free data. Standard = POST /verify/contact, /fit, /verify/batch, pay-per-call via x402 or MPP (first call returns 402 with an accepts[] offer; retry with the X-PAYMENT header), also on open/free data. Pro and Ultra (paid enrichment + premium sources) are coming soon. Inputs: company takes any of {name, domain, address, phone, state}; contact takes {name, email, phone, company}; fit takes plain-language {criteria} plus a company/contact. Set costCeilingUsd and targetConfidence to tune Standard calls. Free reads: GET /status, /plans, POST /quote. Scores are uncalibrated in v1."},"servers":[{"url":"https://everenrich.fly.dev"}],"paths":{"/status":{"get":{"summary":"Service status and source availability","description":"Confirms the service is up and lists which sources are live vs mock.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"security":[]}},"/quote":{"post":{"summary":"Quote the expected cost of a call","description":"Returns the expected cost range before a paid call, given the capability, target confidence and budget.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"capability":{"type":"string","enum":["verify_company","verify_contact","fit"]},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"phone":{"type":"string","minLength":1},"profileUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["company"],"additionalProperties":false}},"required":["capability"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"example":{"capability":"verify_company","company":{"domain":"exampleplumbing.com"}}}}},"security":[]}},"/verify/company":{"post":{"summary":"Verify a US company","description":"Decides whether a company exists, is active, and whether its identifiers belong together, on open/free data sources. Returns typed decisions, evidence, conflicts and per-call cost.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}},"402":{"description":"Payment required (x402 / MPP). Retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}}},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"example":{"domain":"exampleplumbing.com","state":"NJ"}}}},"x-payment-info":{"pricingMode":"fixed","price":"0.050000","protocols":["x402","mpp"],"network":"eip155:8453","asset":"USDC","payTo":"0x3429F0990B83e330F99F287940616B5284E8D5f5"},"x-bazaar":{"schema":{"properties":{"input":{"allOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}}},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"output":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}}}},"/verify/contact":{"post":{"summary":"Verify a US contact","description":"Decides whether a person exists, works at the company, and can be reached by the given email and phone.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}},"402":{"description":"Payment required (x402 / MPP). Retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"phone":{"type":"string","minLength":1},"profileUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["company"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"example":{"name":"Jane Rivera","email":"jane@exampleplumbing.com","title":"Operations Manager","company":{"domain":"exampleplumbing.com"}}}}},"x-payment-info":{"pricingMode":"fixed","price":"0.050000","protocols":["x402","mpp"],"network":"eip155:8453","asset":"USDC","payTo":"0x3429F0990B83e330F99F287940616B5284E8D5f5"},"x-bazaar":{"schema":{"properties":{"input":{"allOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"phone":{"type":"string","minLength":1},"profileUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["company"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"output":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}}}},"/fit":{"post":{"summary":"Score fit against plain-language criteria","description":"Scores a company or contact against criteria written in plain language; returns how each criterion was read and a per-criterion typed decision.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}},"402":{"description":"Payment required (x402 / MPP). Retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"criteria":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"phone":{"type":"string","minLength":1},"profileUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["company"],"additionalProperties":false}},"required":["criteria"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"example":{"criteria":"home-services companies in NJ or PA, 10 to 50 employees","company":{"domain":"exampleplumbing.com","state":"NJ"}}}}},"x-payment-info":{"pricingMode":"fixed","price":"0.050000","protocols":["x402","mpp"],"network":"eip155:8453","asset":"USDC","payTo":"0x3429F0990B83e330F99F287940616B5284E8D5f5"},"x-bazaar":{"schema":{"properties":{"input":{"allOf":[{"type":"object","properties":{"criteria":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"phone":{"type":"string","minLength":1},"profileUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"company":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["company"],"additionalProperties":false}},"required":["criteria"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"output":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}}}},"/verify/batch":{"post":{"summary":"Verify a list of US companies","description":"Verifies up to 25 companies in one call; returns per-item decisions and a batch cost total.","responses":{"200":{"description":"Typed decision response","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}},"402":{"description":"Payment required (x402 / MPP). Retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false},"minItems":1,"maxItems":25}},"required":["items"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"example":{"items":[{"domain":"exampleplumbing.com"},{"domain":"northside-hvac.com"}]}}}},"x-payment-info":{"pricingMode":"fixed","price":"0.050000","protocols":["x402","mpp"],"network":"eip155:8453","asset":"USDC","payTo":"0x3429F0990B83e330F99F287940616B5284E8D5f5"},"x-bazaar":{"schema":{"properties":{"input":{"allOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1}},"additionalProperties":false},"minItems":1,"maxItems":25}},"required":["items"]},{"type":"object","properties":{"targetConfidence":{"type":"number","minimum":0,"maximum":1},"costCeilingUsd":{"type":"number","exclusiveMinimum":0}}}]},"output":{"type":"object","properties":{"entity":{"type":"object","description":"The resolved company or contact the answer is about"},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"type":{"type":"string","enum":["yes_no","score","choice"]},"answer":{"type":"string","description":"'yes' | 'no' | a level | 'unknown'"},"probability":{"type":["number","null"]},"distribution":{"type":["object","null"]},"confidence":{"type":"string","enum":["none","low","medium","high"]},"evidence_refs":{"type":"array","items":{"type":"integer"}}},"required":["id","type","answer","confidence"]}},"headline":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"},"method":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"conflicts":{"type":"array","items":{"type":"object"}},"missing_inputs":{"type":"array","items":{"type":"string"}},"cost":{"type":"object","properties":{"total_usd":{"type":"number"},"by_source":{"type":"object"},"budget_remaining_usd":{"type":"number"}}},"flags":{"type":"array","items":{"type":"string"},"description":"Always includes 'uncalibrated' in v1"}},"required":["entity","decisions","headline","cost","flags"]}}}}}}}}