read_verification_results
Read email/phone verification results, per-address waterfall history, freshness reports, provider stats, durable run records, and the compatibility credit balance.
# 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`
Scheduler Zero