{"openapi":"3.1.0","info":{"title":"Email Verifier API","description":"Email verification and management API","version":"1.0.0"},"paths":{"/api/v1/api-email-verifier/request/":{"post":{"tags":["Email Verifier API"],"summary":"Create Email Verifier Request","description":"Create a new email verification request through Email Verifier API.\n\nThis endpoint accepts emails for verification and returns a tracking response.\nThe X-API-Key header is required for authentication.","operationId":"create_email_verifier_request","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightEmailsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightEmailsResponse"}}}},"201":{"description":"Email Verifiers request created successfully"},"400":{"description":"Invalid input data or insufficient credits"},"401":{"description":"API key required"},"403":{"description":"Invalid API key"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/api-email-verifier/request/{request_history_id}":{"get":{"tags":["Email Verifier API"],"summary":"Get Email Verifier Request","description":"Retrieve a Email Verifier request by ID.\nThe X-API-Key header is required for authentication.","operationId":"get_email_verifier_request","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"request_history_id","in":"path","required":true,"schema":{"type":"integer","title":"Request History Id"}}],"responses":{"200":{"description":"Email Verifiers request retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightEmailsResponse"}}}},"401":{"description":"API key required"},"403":{"description":"Invalid API key"},"404":{"description":"Request not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-email-verifier/request/batch":{"post":{"tags":["Email Verifier API"],"summary":"Get Multiple Email Verifier Requests","description":"Retrieve multiple Emailverifier requests by their IDs.\nThe X-API-Key header is required for authentication.","operationId":"get_multiple_email_verifier_requests","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightEmailsBatchRequest"}}},"required":true},"responses":{"200":{"description":"Email Verifiers requests retrieved successfully","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RightEmailsResponse"},"type":"array","title":"Response Get Multiple Email Verifier Requests"}}}},"401":{"description":"API key required"},"403":{"description":"Invalid API key"},"404":{"description":"All requested IDs were not found"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}}},"components":{"schemas":{"DetailsResponse":{"properties":{"data_count":{"type":"integer","title":"Data Count"},"request_body":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Request Body"},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/EmailResult"},"type":"array"},{"type":"null"}],"title":"Results"},"progress":{"type":"number","title":"Progress"}},"type":"object","required":["data_count","request_body","progress"],"title":"DetailsResponse","description":"Schema for details response in Email Verifier API"},"EmailResult":{"properties":{"email":{"type":"string","title":"Email"},"status":{"type":"string","title":"Status","default":"unknown"}},"type":"object","required":["email"],"title":"EmailResult","description":"Schema for individual email verification result"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistoryResponse":{"properties":{"id":{"type":"integer","title":"Id"},"request_origin":{"type":"string","title":"Request Origin"},"status":{"$ref":"#/components/schemas/RequestStatus"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","request_origin","status","created_at","updated_at"],"title":"HistoryResponse","description":"Schema for history response in Email Verifier API"},"RequestStatus":{"type":"string","enum":["pending","processing","completed","failed","retrying","paused","restarted"],"title":"RequestStatus"},"RequestType":{"type":"string","enum":["verifier","finder"],"title":"RequestType"},"RightEmailsBatchRequest":{"properties":{"request_history_ids":{"items":{"type":"integer"},"type":"array","title":"Request History Ids"}},"type":"object","required":["request_history_ids"],"title":"RightEmailsBatchRequest","description":"Schema for batch retrieval of Email Verifier requests"},"RightEmailsRequest":{"properties":{"request_type":{"anyOf":[{"$ref":"#/components/schemas/RequestType"},{"type":"null"}],"description":"Request type (verifier)","default":"verifier"},"request_origin":{"type":"string","maxLength":255,"title":"Request Origin"},"request_body":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Request Body","description":"List of emails to verify"},"results":{"anyOf":[{"items":{"$ref":"#/components/schemas/EmailResult"},"type":"array"},{"type":"null"}],"title":"Results"}},"type":"object","required":["request_origin","request_body"],"title":"RightEmailsRequest","description":"Schema for Email Verifier API request"},"RightEmailsResponse":{"properties":{"history":{"$ref":"#/components/schemas/HistoryResponse"},"details":{"$ref":"#/components/schemas/DetailsResponse"}},"type":"object","required":["history","details"],"title":"RightEmailsResponse","description":"Schema for Email Verifier API response"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}