{"openapi":"3.1.0","info":{"title":"ListMint Service API","version":"1.0.0","description":"Workspace-scoped API for lists, subscribers, embed forms, and usage summaries."},"servers":[{"url":"/service-api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"List":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","slug","name","status"]},"Subscriber":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string","format":"email"},"status":{"type":"string"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]}},"required":["id","email","status"]},"EmbedForm":{"type":"object","properties":{"id":{"type":"string"},"listId":{"type":"string"},"name":{"type":"string"},"publicFormKey":{"type":"string"},"status":{"type":"string"}},"required":["id","listId","name","publicFormKey","status"]},"UsageSummary":{"type":"object","properties":{"eventType":{"type":"string"},"totalQuantity":{"type":"number"}},"required":["eventType","totalQuantity"]},"EmailValidationResponse":{"type":"object","properties":{"email":{"type":"string","format":"email"},"isValid":{"type":"boolean"},"reason":{"type":"string"},"suggestedCorrection":{"type":"string"},"providerStatus":{"type":"string","enum":["not_configured","verified","unavailable","unknown"]},"riskSignals":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string","enum":["allow","challenge","block"]}},"required":["email","isValid"]}}},"paths":{"/lists":{"get":{"summary":"List workspace lists","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/List"}}}}}}}}}},"/lists/{listId}":{"get":{"summary":"Get a single list","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}}}},"/lists/{listId}/subscribers":{"get":{"summary":"List subscribers for a list","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Subscriber"}}}}}}}}}},"/lists/{listId}/forms":{"get":{"summary":"List embed forms for a list","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/EmbedForm"}}}}}}}}}},"/usage":{"get":{"summary":"List usage summaries by event type","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"serviceCustomerId":{"type":"string"},"summaries":{"type":"array","items":{"$ref":"#/components/schemas/UsageSummary"}}}}}}}}}}}},"/email-validation":{"post":{"summary":"Validate an email address","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"$ref":"#/components/schemas/EmailValidationResponse"}}}}}}}}}}}