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

# How to Export the Blocklist

Export the blocklist when you need a full list of the invalid contacts Maestra is blocking from your sends — for audits, troubleshooting deliverability, or cross-checking against another system.

## How to export the blocklist

**1. Open the customers list**

Go to **Data** → **Customers**.

**2. Start the export**

Open the menu and select **Export blocklist**.

**3. Wait for the export task**

Maestra creates an export task. When it finishes, open the data file from the link provided.

## Fields in the exported file

| Field | Description |
| - | - |
| `FakeContactContact` | The invalid contact itself. |
| `FakeContactContactType` | Contact type: `Email`, `MobilePhone`, `ExternalIdentity`, `Device`, or `DiscountCardNumber`. |
| `FakeContactCustomFieldSystemName` | System identifier name. Populated for `ExternalIdentity` contacts. |
| `FakeContactCreationDateTimeUtc` | Date and time the contact was added to the blocklist (UTC). |
| `FakeContactDescription` | Reason the contact was added. See below. |

### Possible values for `FakeContactDescription`

* **Basic invalid contacts list** — the contact belongs to the built-in list of invalid contacts.
* **Edit/merge limit exceeded (N times per hour)** — the contact was added because the edit or merge limit was exceeded N times within an hour.
* **Bulk operation — Blocklist import. Task ID N** — the contact was added through a bulk blocklist import; `N` is the import task ID.

## What to expect for older entries

> [!NOTE]
>
> For contacts added **before December 20, 2023** through an import or because a limit was exceeded, the time added and the reason for inclusion are not displayed in the export.

For contacts in the **basic invalid contacts list**:

* The reason is always displayed.
* The addition time corresponds to the project's creation date and is only displayed for projects created after December 20, 2023.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.