> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniverifier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Results

> Retrieve the catchall detection results for a completed catchall detection list

{/* 
<Note>
This endpoint requires authentication. Include your API key in the `x-api-key` header.
</Note>

## Get Catchall List Results

Retrieve the catchall detection results for a completed catchall detection list. This endpoint should only be called after the list status is `completed`.

### Request

```bash
GET https://api.omniverifier.com/v1/catchall/list/{listId}/results
```

**Headers:**
```
x-api-key: your_api_key_here
```

### Response

```json
{
"results": [
  {
    "email_nominal": "user@example.com",
    "status": "good",
    "reason": "Low catchall probability",
    "is_catchall": false,
    "score": 0.1,
    "provider": "gmail"
  },
  {
    "email_nominal": "test@domain.com",
    "status": "risky",
    "reason": "Medium catchall probability",
    "is_catchall": true,
    "score": 0.5,
    "provider": "risky-domain"
  },
  {
    "email_nominal": "admin@catchall-domain.com",
    "status": "bad",
    "reason": "High catchall probability",
    "is_catchall": true,
    "score": 0.9,
    "provider": "catchall"
  }
]
}
```

## Path Parameters

<ResponseField name="listId" type="string">
The list identifier returned from the bulk catchall submission endpoint
</ResponseField>

## Response Fields

<ResponseField name="results" type="array">
Array of catchall detection results for each email in the list
</ResponseField>

<ResponseField name="email_nominal" type="string">
The email address that was checked for catchall detection
</ResponseField>

<ResponseField name="status" type="string">
Catchall detection status:
- `good`: Low catchall probability (score 0.0-0.3)
- `risky`: Medium catchall probability (score 0.3-0.7)
- `bad`: High catchall probability (score 0.7-1.0)
</ResponseField>

<ResponseField name="reason" type="string">
Human-readable explanation of the catchall detection result
</ResponseField>

<ResponseField name="is_catchall" type="boolean">
Whether the domain is detected as a catchall domain
</ResponseField>

<ResponseField name="score" type="float">
Catchall toxicity score (0.0 to 1.0):
- `0.0-0.3`: Low catchall probability
- `0.3-0.7`: Medium catchall probability
- `0.7-1.0`: High catchall probability
</ResponseField>

<ResponseField name="provider" type="string">
Email provider or service identifier
</ResponseField>

## Score Interpretation

- **`0.0 - 0.3`** - Low catchall probability. The domain is likely to be a legitimate email domain.
- **`0.3 - 0.7`** - Medium catchall probability. Exercise caution with this domain.
- **`0.7 - 1.0`** - High catchall probability. This domain is likely a catchall domain that accepts all emails.

## Error Responses

### Unauthorized (401)

```json
{
"error": "Unauthorized",
"message": "Invalid or missing API key"
}
```

### Not Found (404)

```json
{
"error": "Not Found",
"message": "List not found"
}
```

### Conflict (409)

```json
{
"error": "Conflict",
"message": "List not completed yet"
}
```

### Internal Server Error (500)

```json
{
"error": "Internal Server Error",
"message": "Failed to get list results"
}
```

## Usage Examples

### JavaScript Example

```javascript
const response = await fetch('https://api.omniverifier.com/v1/catchall/list/list_1234567890/results', {
headers: {
  'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log('Results:', data.results);
```

### Python Example

```python
import requests

response = requests.get(
  'https://api.omniverifier.com/v1/catchall/list/list_1234567890/results',
  headers={'x-api-key': 'your_api_key_here'}
)
data = response.json()
print('Results:', data['results'])
```  */}