{"openapi":"3.1.0","info":{"title":"ZAIGOOD Compliance API","version":"1.0.0-beta","description":"AI-agent-ready API for business entity lookup and compliance tracking. Search state registries, get compliance checklists, and understand filing obligations programmatically.","contact":{"name":"Zak El Fassi","url":"https://zaigood.com"}},"servers":[{"url":"https://zaigood.com/api/v1","description":"Production"}],"paths":{"/entity":{"post":{"operationId":"lookupEntity","summary":"Look up a business entity in a state registry","description":"Searches the specified state registry for a business entity by name. Returns entity details including file number, entity type, incorporation date, registered agent, and status (when available). Results are cached for 24 hours.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","state"],"properties":{"name":{"type":"string","description":"Legal entity name (exact match preferred)","example":"ZAIGOOD, INC."},"state":{"type":"string","description":"2-letter US state code","enum":["DE","CA","WY"],"example":"DE"}}}}}},"responses":{"200":{"description":"Entity lookup result","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"found":{"type":"boolean","const":true},"entity":{"$ref":"#/components/schemas/Entity"}}},{"type":"object","properties":{"found":{"type":"boolean","const":false},"query":{"type":"object","properties":{"name":{"type":"string"},"state":{"type":"string"}}},"suggestions":{"type":"array","items":{"type":"string"}}}}]}}}}}}},"/compliance":{"post":{"operationId":"checkCompliance","summary":"Run a compliance health check for an entity","description":"Performs a registry lookup (when available) and generates a compliance checklist based on the entity jurisdiction, type, and incorporation date. Returns filing obligations, deadlines, penalties, and action items.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","state"],"properties":{"name":{"type":"string","description":"Legal entity name","example":"THE AI COACH, INC."},"state":{"type":"string","description":"2-letter US state code","enum":["DE","CA","WY"]},"entity_type":{"type":"string","enum":["c-corp","s-corp","llc","lp"],"description":"Entity type (auto-detected from registry if omitted)"},"incorporation_date":{"type":"string","format":"date","description":"YYYY-MM-DD (pulled from registry if available)"}}}}}},"responses":{"200":{"description":"Compliance check result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceResult"}}}}}}},"/rules":{"get":{"operationId":"listRules","summary":"List compliance rules for a jurisdiction","description":"Returns all compliance rules for a given state. Useful for understanding what obligations exist without running a full entity check.","parameters":[{"name":"state","in":"query","schema":{"type":"string","enum":["DE","CA","WY"]},"description":"Filter rules by state (returns all if omitted)"}],"responses":{"200":{"description":"List of compliance rules"}}}}},"components":{"schemas":{"Entity":{"type":"object","properties":{"entityName":{"type":"string"},"fileNumber":{"type":"string"},"entityType":{"type":"string","nullable":true},"incorporationDate":{"type":"string","nullable":true},"status":{"type":"string"},"jurisdiction":{"type":"string"},"residency":{"type":"string","nullable":true},"registeredAgent":{"type":"object","nullable":true,"properties":{"name":{"type":"string"},"address":{"type":"string"}}},"source":{"type":"string"}}},"ComplianceResult":{"type":"object","properties":{"entity":{"$ref":"#/components/schemas/Entity","nullable":true},"compliance_items":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"dueDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["pending","overdue","na"]},"penalty":{"type":"string","nullable":true},"filingCost":{"type":"number","nullable":true},"difficulty":{"type":"string"},"actionUrl":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true}}}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"overdue":{"type":"integer"},"pending":{"type":"integer"},"has_entity_data":{"type":"boolean"}}},"disclaimer":{"type":"string"}}}}}}