# MCP tool reference 1 callable tools. Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference. Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result. [Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt) ## read_verification_results Read email/phone verification results, per-address waterfall history, freshness reports, provider stats, durable run records, and the compatibility credit balance. Use to inspect verdicts and run progress, pre-flight freshness before a bulk run, or check provider unit economics for the workspace. Results are workspace-scoped — another organization's provider verdicts are never visible; this tool cannot start verification or manage keys. Scopes: emailVerification:read, phoneVerification:read Risk: read; confirmation: none; idempotency: none. ### Input schema (personal API key) ```json { "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "channel": { "type": "string", "enum": [ "email", "phone" ] }, "action": { "type": "string", "enum": [ "result", "results", "history", "freshness", "provider_stats", "runs", "run", "run_status", "credit_balance", "estimate_credits" ] }, "email": { "$ref": "#/$defs/EmailAddress" }, "phone": { "$ref": "#/$defs/PhoneNumberInput" }, "phones": { "type": "array", "items": { "$ref": "#/$defs/PhoneNumberInput" }, "minItems": 1, "maxItems": 500 }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } ] }, "freshness": { "type": "object", "properties": { "emails": { "type": "array", "items": { "$ref": "#/$defs/EmailAddress" }, "maxItems": 5000 }, "scope": { "type": "object", "properties": { "campaignId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "search": { "$ref": "#/$defs/ShortText" }, "assigneeUserIds": { "type": "array", "items": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } } }, "required": [ "campaignId" ], "patternProperties": { "^(?!(?:campaignId|search|assigneeUserIds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "campaignId", "search", "assigneeUserIds" ] } } }, "patternProperties": { "^(?!(?:emails|scope)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "emails", "scope" ] } }, "estimate": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1 } }, "required": [ "count" ], "patternProperties": { "^(?!(?:count)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "count" ] } ] } }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 } }, "required": [ "workspaceId", "channel", "action" ], "patternProperties": { "^(?!(?:workspaceId|channel|action|email|phone|phones|runId|freshness|estimate|limit)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "channel", "action", "email", "phone", "phones", "runId", "freshness", "estimate", "limit" ] }, "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "PhoneNumberInput": { "type": "string", "minLength": 1, "maxLength": 64 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 } } } ``` ### Input schema (OAuth / delegated agent) ```json { "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "channel": { "type": "string", "enum": [ "email", "phone" ] }, "action": { "type": "string", "enum": [ "result", "results", "history", "freshness", "provider_stats", "runs", "run", "run_status", "credit_balance", "estimate_credits" ] }, "email": { "$ref": "#/$defs/EmailAddress" }, "phone": { "$ref": "#/$defs/PhoneNumberInput" }, "phones": { "type": "array", "items": { "$ref": "#/$defs/PhoneNumberInput" }, "minItems": 1, "maxItems": 500 }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } ] }, "freshness": { "type": "object", "properties": { "emails": { "type": "array", "items": { "$ref": "#/$defs/EmailAddress" }, "maxItems": 5000 }, "scope": { "type": "object", "properties": { "campaignId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "search": { "$ref": "#/$defs/ShortText" }, "assigneeUserIds": { "type": "array", "items": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" } } }, "required": [ "campaignId" ], "patternProperties": { "^(?!(?:campaignId|search|assigneeUserIds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "campaignId", "search", "assigneeUserIds" ] } } }, "patternProperties": { "^(?!(?:emails|scope)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "emails", "scope" ] } }, "estimate": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1 } }, "required": [ "count" ], "patternProperties": { "^(?!(?:count)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "count" ] } ] } }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 } }, "required": [ "workspaceId", "channel", "action" ], "patternProperties": { "^(?!(?:workspaceId|channel|action|email|phone|phones|runId|freshness|estimate|limit)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "channel", "action", "email", "phone", "phones", "runId", "freshness", "estimate", "limit" ] }, "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "PhoneNumberInput": { "type": "string", "minLength": 1, "maxLength": 64 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 } } } ``` ### Output schema (structuredContent) ```json { "$defs": { "EmailAddress": { "type": "string", "minLength": 3, "maxLength": 320, "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$" }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "cache", "dns", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "email", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "provider", "dns", "sending-signal", "cache" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "email", "status", "source", "confidence", "verifiedAt" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "runs": { "type": "array", "items": { "type": "object", "properties": { "requestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "hops": { "type": "array", "items": { "type": "object", "properties": { "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "provider", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:provider|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "provider", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "requestId", "checkedAt", "hops" ], "patternProperties": { "^(?!(?:requestId|checkedAt|hops)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "requestId", "checkedAt", "hops" ] } } } }, "required": [ "email", "runs" ], "patternProperties": { "^(?!(?:email|runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "runs" ] } }, { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "knownCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mostRecentAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "capped": { "type": "boolean" }, "cap": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "known": { "type": "array", "items": { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "lastVerifiedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "email", "status", "lastVerifiedAt" ], "patternProperties": { "^(?!(?:email|status|lastVerifiedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "lastVerifiedAt" ] } }, "maxItems": 100 } }, "required": [ "total", "knownCount", "mostRecentAt", "capped", "cap", "known" ], "patternProperties": { "^(?!(?:total|knownCount|mostRecentAt|capped|cap|known)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "knownCount", "mostRecentAt", "capped", "cap", "known" ] } }, { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object", "properties": { "provider": { "$ref": "#/$defs/ShortText" }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolved": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "provider", "attempts", "resolved", "resolvedValid", "resolvedInvalid", "resolvedCatchAll" ], "patternProperties": { "^(?!(?:provider|attempts|resolved|resolvedValid|resolvedInvalid|resolvedCatchAll)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "provider", "attempts", "resolved", "resolvedValid", "resolvedInvalid", "resolvedCatchAll" ] } } } }, "required": [ "providers" ], "patternProperties": { "^(?!(?:providers)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "providers" ] } ] } }, { "type": "object", "properties": { "runs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countCatchAll|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } } } }, "required": [ "runs" ], "patternProperties": { "^(?!(?:runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "runs" ] } ] } }, { "anyOf": [ { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countCatchAll|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "provider": { "$ref": "#/$defs/ShortText" } }, "required": [ "email", "status", "provider" ], "patternProperties": { "^(?!(?:email|status|provider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "provider" ] } } } }, "required": [ "run", "addresses" ], "patternProperties": { "^(?!(?:run|addresses)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "run", "addresses" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "state": { "type": "string", "enum": [ "idle", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "counts": { "type": "object", "properties": { "valid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "invalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "unknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "valid", "invalid", "catchAll", "unknown" ], "patternProperties": { "^(?!(?:valid|invalid|catchAll|unknown)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "valid", "invalid", "catchAll", "unknown" ] } } }, "required": [ "runId", "state", "total", "processed", "progress", "counts" ], "patternProperties": { "^(?!(?:runId|state|total|processed|progress|counts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "state", "total", "processed", "progress", "counts" ] } }, { "type": "object", "properties": { "billingEnabled": { "type": "boolean", "enum": [ false ] }, "balance": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "reserved": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "available": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] } }, "required": [ "billingEnabled", "balance", "reserved", "available" ], "patternProperties": { "^(?!(?:billingEnabled|balance|reserved|available)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "billingEnabled", "balance", "reserved", "available" ] } }, { "type": "object", "properties": { "estimatedCredits": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] } }, "required": [ "estimatedCredits" ], "patternProperties": { "^(?!(?:estimatedCredits)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "estimatedCredits" ] } ] } }, { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "source": { "type": "string", "enum": [ "cache", "format", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "lineType": { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, "carrier": { "$ref": "#/$defs/ShortText" }, "isPrepaid": { "type": "boolean" }, "activityScore": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "isLitigatorRisk": { "type": "boolean" }, "countryCode": { "$ref": "#/$defs/ShortText" }, "e164Format": { "$ref": "#/$defs/ShortText" } }, "patternProperties": { "^(?!(?:lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "phone", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:phone|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "phoneNumber": { "$ref": "#/$defs/ShortText" }, "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "countryCode": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "verificationRequestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "resolved": { "type": "boolean" }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|phoneNumber|provider|status|rawStatus|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format|verificationRequestId|runId|resolved|checkedAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "phoneNumber": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "provider": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "phoneNumber", "status", "provider", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "e164Format", "checkedAt" ], "patternProperties": { "^(?!(?:phoneNumber|status|provider|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|e164Format|checkedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phoneNumber", "status", "provider", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "e164Format", "checkedAt" ] } } } }, "required": [ "results" ], "patternProperties": { "^(?!(?:results)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "results" ] } ] } }, { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "phoneNumber": { "$ref": "#/$defs/ShortText" }, "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "countryCode": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "verificationRequestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "resolved": { "type": "boolean" }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|phoneNumber|provider|status|rawStatus|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format|verificationRequestId|runId|resolved|checkedAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ] } } } }, "required": [ "results" ], "patternProperties": { "^(?!(?:results)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "results" ] } ] } }, { "type": "object", "properties": { "runs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } } } }, "required": [ "runs" ], "patternProperties": { "^(?!(?:runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "runs" ] } ] } }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "state": { "type": "string", "enum": [ "idle", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "counts": { "type": "object", "properties": { "valid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "invalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "unknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "valid", "invalid", "unknown" ], "patternProperties": { "^(?!(?:valid|invalid|unknown)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] } } }, "required": [ "runId", "state", "total", "processed", "progress", "counts" ], "patternProperties": { "^(?!(?:runId|state|total|processed|progress|counts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "state", "total", "processed", "progress", "counts" ] } } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "cache", "dns", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "email", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "anyOf": [ { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "source": { "type": "string", "enum": [ "provider", "dns", "sending-signal", "cache" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "role": { "type": "boolean" }, "disposable": { "type": "boolean" }, "spamtrap": { "type": "boolean" }, "freeProvider": { "type": "boolean" } }, "patternProperties": { "^(?!(?:role|disposable|spamtrap|freeProvider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "role", "disposable", "spamtrap", "freeProvider" ] } }, "verifiedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "email", "status", "source", "confidence", "verifiedAt" ], "patternProperties": { "^(?!(?:email|status|source|provider|confidence|flags|verifiedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "source", "provider", "confidence", "flags", "verifiedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "runs": { "type": "array", "items": { "type": "object", "properties": { "requestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "hops": { "type": "array", "items": { "type": "object", "properties": { "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "provider", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:provider|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "provider", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "requestId", "checkedAt", "hops" ], "patternProperties": { "^(?!(?:requestId|checkedAt|hops)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "requestId", "checkedAt", "hops" ] } } } }, "required": [ "email", "runs" ], "patternProperties": { "^(?!(?:email|runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "runs" ] } }, { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "knownCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mostRecentAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "capped": { "type": "boolean" }, "cap": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "known": { "type": "array", "items": { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "lastVerifiedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "email", "status", "lastVerifiedAt" ], "patternProperties": { "^(?!(?:email|status|lastVerifiedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "lastVerifiedAt" ] } }, "maxItems": 100 } }, "required": [ "total", "knownCount", "mostRecentAt", "capped", "cap", "known" ], "patternProperties": { "^(?!(?:total|knownCount|mostRecentAt|capped|cap|known)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "knownCount", "mostRecentAt", "capped", "cap", "known" ] } }, { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object", "properties": { "provider": { "$ref": "#/$defs/ShortText" }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolved": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resolvedCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "provider", "attempts", "resolved", "resolvedValid", "resolvedInvalid", "resolvedCatchAll" ], "patternProperties": { "^(?!(?:provider|attempts|resolved|resolvedValid|resolvedInvalid|resolvedCatchAll)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "provider", "attempts", "resolved", "resolvedValid", "resolvedInvalid", "resolvedCatchAll" ] } } } }, "required": [ "providers" ], "patternProperties": { "^(?!(?:providers)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "providers" ] } ] } }, { "type": "object", "properties": { "runs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countCatchAll|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } } } }, "required": [ "runs" ], "patternProperties": { "^(?!(?:runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "runs" ] } ] } }, { "anyOf": [ { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countCatchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countCatchAll|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countCatchAll", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "email": { "$ref": "#/$defs/EmailAddress" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "provider": { "$ref": "#/$defs/ShortText" } }, "required": [ "email", "status", "provider" ], "patternProperties": { "^(?!(?:email|status|provider)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "email", "status", "provider" ] } } } }, "required": [ "run", "addresses" ], "patternProperties": { "^(?!(?:run|addresses)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "run", "addresses" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "state": { "type": "string", "enum": [ "idle", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "counts": { "type": "object", "properties": { "valid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "invalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catchAll": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "unknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "valid", "invalid", "catchAll", "unknown" ], "patternProperties": { "^(?!(?:valid|invalid|catchAll|unknown)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "valid", "invalid", "catchAll", "unknown" ] } } }, "required": [ "runId", "state", "total", "processed", "progress", "counts" ], "patternProperties": { "^(?!(?:runId|state|total|processed|progress|counts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "state", "total", "processed", "progress", "counts" ] } }, { "type": "object", "properties": { "billingEnabled": { "type": "boolean", "enum": [ false ] }, "balance": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "reserved": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "available": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] } }, "required": [ "billingEnabled", "balance", "reserved", "available" ], "patternProperties": { "^(?!(?:billingEnabled|balance|reserved|available)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "billingEnabled", "balance", "reserved", "available" ] } }, { "type": "object", "properties": { "estimatedCredits": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] } }, "required": [ "estimatedCredits" ], "patternProperties": { "^(?!(?:estimatedCredits)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "estimatedCredits" ] } ] } }, { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "source": { "type": "string", "enum": [ "cache", "format", "provider" ] }, "provider": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "flags": { "type": "object", "properties": { "lineType": { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, "carrier": { "$ref": "#/$defs/ShortText" }, "isPrepaid": { "type": "boolean" }, "activityScore": { "anyOf": [ { "type": "number" }, { "type": "string", "enum": [ "Infinity", "-Infinity", "NaN" ] } ] }, "isLitigatorRisk": { "type": "boolean" }, "countryCode": { "$ref": "#/$defs/ShortText" }, "e164Format": { "$ref": "#/$defs/ShortText" } }, "patternProperties": { "^(?!(?:lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format" ] } }, "verifiedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "fromCache": { "type": "boolean" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "providerId": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "disposable", "role", "spamtrap" ] }, "rawStatus": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "resolved": { "type": "boolean" } }, "required": [ "providerId", "status", "rawStatus", "confidence", "resolved" ], "patternProperties": { "^(?!(?:providerId|status|rawStatus|confidence|resolved)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "providerId", "status", "rawStatus", "confidence", "resolved" ] } } } }, "required": [ "phone", "status", "source", "provider", "confidence", "verifiedAt", "fromCache", "attempts" ], "patternProperties": { "^(?!(?:phone|status|source|provider|confidence|flags|verifiedAt|fromCache|attempts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "status", "source", "provider", "confidence", "flags", "verifiedAt", "fromCache", "attempts" ] } }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "phoneNumber": { "$ref": "#/$defs/ShortText" }, "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "countryCode": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "verificationRequestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "resolved": { "type": "boolean" }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|phoneNumber|provider|status|rawStatus|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format|verificationRequestId|runId|resolved|checkedAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "phoneNumber": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "provider": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "phoneNumber", "status", "provider", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "e164Format", "checkedAt" ], "patternProperties": { "^(?!(?:phoneNumber|status|provider|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|e164Format|checkedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phoneNumber", "status", "provider", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "e164Format", "checkedAt" ] } } } }, "required": [ "results" ], "patternProperties": { "^(?!(?:results)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "results" ] } ] } }, { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "phoneNumber": { "$ref": "#/$defs/ShortText" }, "provider": { "$ref": "#/$defs/ShortText" }, "status": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] }, "rawStatus": { "$ref": "#/$defs/ShortText" }, "confidence": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "lineType": { "anyOf": [ { "type": "string", "enum": [ "mobile", "landline", "voip", "toll_free", "premium", "unknown" ] }, { "type": "null" } ] }, "carrier": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "isPrepaid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "activityScore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "isLitigatorRisk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "countryCode": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "e164Format": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "verificationRequestId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "runId": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "resolved": { "type": "boolean" }, "checkedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|phoneNumber|provider|status|rawStatus|confidence|lineType|carrier|isPrepaid|activityScore|isLitigatorRisk|countryCode|e164Format|verificationRequestId|runId|resolved|checkedAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "phoneNumber", "provider", "status", "rawStatus", "confidence", "lineType", "carrier", "isPrepaid", "activityScore", "isLitigatorRisk", "countryCode", "e164Format", "verificationRequestId", "runId", "resolved", "checkedAt", "createdAt", "updatedAt" ] } } } }, "required": [ "results" ], "patternProperties": { "^(?!(?:results)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "results" ] } ] } }, { "type": "object", "properties": { "runs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } } } }, "required": [ "runs" ], "patternProperties": { "^(?!(?:runs)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "runs" ] } ] } }, { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "kind": { "type": "string", "enum": [ "single", "bulk" ] }, "status": { "type": "string", "enum": [ "queued", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countValid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countInvalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "countUnknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ], "patternProperties": { "^(?!(?:id|kind|status|total|processed|countValid|countInvalid|countUnknown|requestedBy|createdAt|completedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "kind", "status", "total", "processed", "countValid", "countInvalid", "countUnknown", "requestedBy", "createdAt", "completedAt" ] } }, { "type": "null" } ] }, { "type": "object", "properties": { "runId": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "state": { "type": "string", "enum": [ "idle", "running", "completed", "failed" ] }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "processed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "counts": { "type": "object", "properties": { "valid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "invalid": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "unknown": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "valid", "invalid", "unknown" ], "patternProperties": { "^(?!(?:valid|invalid|unknown)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "valid", "invalid", "unknown" ] } } }, "required": [ "runId", "state", "total", "processed", "progress", "counts" ], "patternProperties": { "^(?!(?:runId|state|total|processed|progress|counts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "runId", "state", "total", "processed", "progress", "counts" ] } } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `emailVerification.status`: `GET /v1/workspaces/:workspaceId/verification/runs/:runId/status` - `emailVerification.getResult`: `GET /v1/workspaces/:workspaceId/verification/results/:email` - `emailVerification.history`: `GET /v1/workspaces/:workspaceId/verification/results/:email/history` - `emailVerification.freshness`: `POST /v1/workspaces/:workspaceId/verification/freshness` - `emailVerification.providerStats`: `GET /v1/workspaces/:workspaceId/verification/provider-stats` - `emailVerification.listRuns`: `GET /v1/workspaces/:workspaceId/verification/runs` - `emailVerification.getRun`: `GET /v1/workspaces/:workspaceId/verification/runs/:runId` - `emailVerification.creditBalance`: `GET /v1/workspaces/:workspaceId/verification/credits` - `emailVerification.estimateCredits`: `POST /v1/workspaces/:workspaceId/verification/credits/estimate` - `phoneVerification.status`: `GET /v1/workspaces/:workspaceId/phone-verification/runs/:runId/status` - `phoneVerification.getResult`: `GET /v1/workspaces/:workspaceId/phone-verification/results/:phone` - `phoneVerification.getResults`: `POST /v1/workspaces/:workspaceId/phone-verification/results/batch` - `phoneVerification.history`: `GET /v1/workspaces/:workspaceId/phone-verification/results/:phone/history` - `phoneVerification.listRuns`: `GET /v1/workspaces/:workspaceId/phone-verification/runs` - `phoneVerification.getRun`: `GET /v1/workspaces/:workspaceId/phone-verification/runs/:runId`