{"openapi":"3.1.0","info":{"title":"DataBoss API","description":"Business utility APIs for CRMs, delivery apps, sales tools, and AI agents.","version":"1.0.0"},"servers":[{"url":"https://databossapi.com"}],"tags":[{"name":"address","description":"Validate, standardize, geocode, and reverse-geocode US addresses via Smarty, Google, Census, or internal ZIP lookup."},{"name":"calculators","description":"Internal loan, RTO, margin, commission, and delivery fee calculators with audit logging."},{"name":"email","description":"Syntax, domain, MX, disposable, and premium email validation with typo suggestions."},{"name":"lead","description":"Combined lead verification, scoring, routing, duplicate detection, and contactability analysis."},{"name":"location","description":"ZIP, city, county, timezone, distance, and service area lookups from internal database."},{"name":"phone","description":"Normalize, validate, and enrich phone numbers with carrier, line type, and SMS capability."},{"name":"tax","description":"Sales tax estimates, calculations, and jurisdiction lookups from internal data, TaxJar, or Avalara."},{"name":"weather","description":"Current, forecast, historical weather and delivery risk scoring."}],"paths":{"/v1/health":{"get":{"summary":"Health check","tags":["Platform"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}}}},"/v1/openapi.json":{"get":{"summary":"OpenAPI specification","tags":["Platform"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}}}},"/v1/address/validate":{"post":{"summary":"validate","tags":["address"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 5","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"street":"123 Main St","city":"Paducah","state":"KY","zip":"42001"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/address/standardize":{"post":{"summary":"standardize","tags":["address"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"street":"123 main st","city":"paducah","state":"KY","zip":"42001"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/address/geocode":{"get":{"summary":"geocode","tags":["address"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"42078 OR address=..."}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/address/reverse-geocode":{"get":{"summary":"reverse-geocode","tags":["address"],"parameters":[{"name":"lat","in":"query","schema":{"type":"string"},"description":"37.0833893"},{"name":"lng","in":"query","schema":{"type":"string"},"description":"-88.6000478"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/payment":{"post":{"summary":"payment","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"principal":10000,"annual_rate":6.5,"term_months":36}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/rto":{"post":{"summary":"rto","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"cash_price":1200,"down_payment":100,"term_weeks":52,"weekly_rate":1.0500000000000000444089209850062616169452667236328125}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/loan":{"post":{"summary":"loan","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"principal":25000,"annual_rate":7.25,"term_months":60}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/margin":{"post":{"summary":"margin","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"cost":80,"selling_price":129.990000000000009094947017729282379150390625}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/commission":{"post":{"summary":"commission","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"sale_amount":5000,"commission_rate":8.5}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/calculators/delivery-fee":{"post":{"summary":"delivery-fee","tags":["calculators"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"distance_miles":18.5,"base_fee":49,"per_mile_rate":2.5}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/email/verify":{"get":{"summary":"verify","tags":["email"],"parameters":[{"name":"email","in":"query","schema":{"type":"string"},"description":"user@gmail.com"},{"name":"premium","in":"query","schema":{"type":"string"},"description":"1 (optional)"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/email/domain-check":{"get":{"summary":"domain-check","tags":["email"],"parameters":[{"name":"email","in":"query","schema":{"type":"string"},"description":"user@gmail.com"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/email/mx-check":{"get":{"summary":"mx-check","tags":["email"],"parameters":[{"name":"email","in":"query","schema":{"type":"string"},"description":"user@gmail.com"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/email/disposable-check":{"get":{"summary":"disposable-check","tags":["email"],"parameters":[{"name":"email","in":"query","schema":{"type":"string"},"description":"user@mailinator.com"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/email/suggest-correction":{"get":{"summary":"suggest-correction","tags":["email"],"parameters":[{"name":"email","in":"query","schema":{"type":"string"},"description":"user@gmai.com"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/email/bulk-verify":{"post":{"summary":"bulk-verify","tags":["email"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 4","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"emails":["a@test.com","b@test.com"]}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/lead/verify":{"post":{"summary":"verify","tags":["lead"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 15","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"phone":"+12705551234","email":"lead@example.com","zip":"42078"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/lead/score":{"post":{"summary":"score","tags":["lead"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 10","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"phone":"+12705551234","email":"lead@example.com","address":{"street":"123 Main","city":"Benton","state":"KY","zip":"42078"}}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/lead/route":{"post":{"summary":"route","tags":["lead"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 5","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"lead":{"state":"KY","zip":"42078"},"rules":[{"type":"state","states":["KY"],"assign_to":"team_ky"}]}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/lead/duplicate-check":{"post":{"summary":"duplicate-check","tags":["lead"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"lead@example.com","phone":"+12705551234"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/lead/contactability":{"post":{"summary":"contactability","tags":["lead"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 8","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"phone":"+12705551234","email":"lead@example.com"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/location/zip/{zip}":{"get":{"summary":"zip/{zip}","tags":["location"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"5-digit ZIP"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/location/city":{"get":{"summary":"city","tags":["location"],"parameters":[{"name":"city","in":"query","schema":{"type":"string"},"description":"City name"},{"name":"state","in":"query","schema":{"type":"string"},"description":"2-letter state"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/location/county":{"get":{"summary":"county","tags":["location"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/location/timezone":{"get":{"summary":"timezone","tags":["location"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/location/distance":{"post":{"summary":"distance","tags":["location"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"from":{"zip":"42078"},"to":{"zip":"42001"}}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/location/service-area":{"post":{"summary":"service-area","tags":["location"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/phone/verify":{"get":{"summary":"verify","tags":["phone"],"parameters":[{"name":"phone","in":"query","schema":{"type":"string"},"description":"+15551234567"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/phone/carrier":{"get":{"summary":"carrier","tags":["phone"],"parameters":[{"name":"phone","in":"query","schema":{"type":"string"},"description":"+15551234567"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/phone/line-type":{"get":{"summary":"line-type","tags":["phone"],"parameters":[{"name":"phone","in":"query","schema":{"type":"string"},"description":"+15551234567"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/phone/sms-capable":{"get":{"summary":"sms-capable","tags":["phone"],"parameters":[{"name":"phone","in":"query","schema":{"type":"string"},"description":"+15551234567"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/phone/bulk-verify":{"post":{"summary":"bulk-verify","tags":["phone"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 5","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"phones":["+15551234567","5559876543"]}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/tax/estimate":{"get":{"summary":"estimate","tags":["tax"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"42078"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 1","security":[{"ApiKeyHeader":[]}]}},"/v1/tax/calculate":{"post":{"summary":"calculate","tags":["tax"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"amount":100,"zip":"42078"}}}},"security":[{"ApiKeyHeader":[]}]}},"/v1/tax/jurisdiction":{"get":{"summary":"jurisdiction","tags":["tax"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"42078"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/weather/current":{"get":{"summary":"current","tags":["weather"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"42078 OR lat/lng OR city&state"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 2","security":[{"ApiKeyHeader":[]}]}},"/v1/weather/forecast":{"get":{"summary":"forecast","tags":["weather"],"parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"42078"},{"name":"days","in":"query","schema":{"type":"string"},"description":"1-14"}],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/weather/history":{"get":{"summary":"history","tags":["weather"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/weather/rain-last-72-hours":{"get":{"summary":"rain-last-72-hours","tags":["weather"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 3","security":[{"ApiKeyHeader":[]}]}},"/v1/weather/delivery-risk":{"post":{"summary":"delivery-risk","tags":["weather"],"parameters":[],"responses":{"200":{"description":"Success"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"}},"description":"Credits: 10","requestBody":{"content":{"application/json":{"schema":{"type":"object"},"example":{"zip":"42078"}}}},"security":[{"ApiKeyHeader":[]}]}}},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}