# AddressListVerdict

The AddressListVerdict type of the TypeScript SDK, which accountAddressLists.evaluate and mailboxAddressLists.evaluate take or answer.

```ts
type AddressListVerdict = {
  allowUnvouched?: AddressListVerdictAllowUnvouched
  decidedBy?: ('catch_all' | 'contact')
  listId?: string
  pattern?: string
  scopeKind?: ('account' | 'domain' | 'mailbox')
  verdict: ('allow' | 'block' | 'none')
}
```

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `allowUnvouched` | [`AddressListVerdictAllowUnvouched`](/docs/sdks/typescript/types/address-list-verdict-allow-unvouched) | Optional. Message simulation only: an allow MATCHED an identity that no SPF pass, DMARC pass or local submission vouched for, so it could not fire. The usual answer to "I allowed them and they are still blocked". |
| `decidedBy` | `('catch_all' \| 'contact')` | Optional. Absent when a named entry decided. `catch_all`: no named entry at any scope matched and the list's `*@*` decided. `contact`: that catch-all's list allows contacts and the sender is in the mailbox's address book. |
| `listId` | `string` | Optional. ID of the address list that matched (if any) |
| `pattern` | `string` | Optional. Specific pattern entry that matched (if any) |
| `scopeKind` | `('account' \| 'domain' \| 'mailbox')` | Optional. Scope level of the matching list (if any) |
| `verdict` | `('allow' \| 'block' \| 'none')` | Policy evaluation result ('allow', 'block', or 'none') |

## Used by

| Method | What it does |
| --- | --- |
| [`accountAddressLists.evaluate`](/docs/sdks/typescript/account-address-lists/evaluate) | Test address list policy against an address |
| [`mailboxAddressLists.evaluate`](/docs/sdks/typescript/mailbox-address-lists/evaluate) | Test address list policy against an address |
