# Batch export content

This article will give you more details about what information is included in the batch export, and high-level examples of use cases where batch export can be a good solution.

{% hint style="info" %}
Batch export is a premium feature. To enable it, please reach out to our Support team.
{% endhint %}

### **🔎 Scope of batch export**

The batch export provides a way to access all user choices (consents and preferences) collected through the Didomi platform at once, for CMP and Preference Management Platform.

Once the batch export is enabled by the Support team and properly configured, you will get the export in JSON dropped in the location configured in agreement with Didomi, every 24h.

The data is available in the export from the moment the feature is enabled (or from Consent API enablement if it is before). 

**Only consent-given types** of events are included in the file (page views are not part of the batch export).

Data in the exported file is **not sampled**. 

For more details regarding feature configuration, please check [this documentation.](https://developers.didomi.io/integrations/batch-export)

### **🗒️ Data definition**

There are two objects with similar fields in the batch export: *User* and *Events*. 

* *User*: last consent a user gives. In other words, the last consent status of the user.
* *Events*: all historical consents a user gave.

You will find below the description of each field you may find in the exported file: 

| **💻 FIELDS**                                             | **📕 DESCRIPTION**                                                                           |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **user.consents**                                         | Consents object for user                                                                     |
| **user.consents.channels**                                | Channels (for Preference Management Platform)                                                |
| **user.consents.channels.id**                             | Channel ID                                                                                   |
| **user.consents.channels.enabled**                        | User choices for the channel                                                                 |
| **user.consents.purposes**                                | Purposes (for both CMP and Preference Management Platform)                                   |
| **user.consents.purposes.enabled**                        | User choices for the purpose based on consent                                                |
| **user.consents.purposes.enabled\_li**                    | User choices for the purpose based on legitimate interest                                    |
| **user.consents.purposes.id**                             | Purpose ID                                                                                   |
| **user.consents.purposes.preferences**                    | Preferences (for Preference Management Platform)                                             |
| **user.consents.purposes.preferences.id**                 | Preference ID                                                                                |
| **user.consents.purposes.preferences.enabled**            | User choices for the preference                                                              |
| **user.consents.purposes.preferences.channels**           | Channels linked to purpose and preference (for Preference Management Platform)               |
| **user.consents.purposes.preferences.channels.id**        | Channel ID linked to purpose and preference                                                  |
| **user.consents.purposes.preferences.channels.enabled**   | User choices for the channel linked to the purpose and preference                            |
| **user.consent.tcfs**                                     | TCF consent string generated by the user (for CMP)                                           |
| **user.consents.vendors**                                 | Vendors object                                                                               |
| **user.consents.vendors.disabled**                        | List of vendors disabled by the user based on consent                                        |
| **user.consents.vendors.disabled\_li**                    | List of vendors disabled by the user based on legitimate interest                            |
| **user.consents.vendors.enabled**                         | List of vendors enabled by the user based on consent                                         |
| **user.consents.vendors.enabled\_li**                     | List of vendors enabled by the user based on legitimate interest                             |
| **user.country**                                          | Country of the user (always set by the client, null otherwise)                               |
| **user.created\_at**                                      | Creation date of the user                                                                    |
| **user.delegate**                                         | Information of the client's employee for signed consent (for Preference Management Platform) |
| **user.id**                                               | Didomi's user ID                                                                             |
| **user.last\_seen\_country**                              | User country based on his last known connexion location                                      |
| **user.metadata**                                         | Metadata of user, defined by the customer                                                    |
| **user.organization\_id**                                 | Didomi's organization ID                                                                     |
| **user.organization\_user\_id**                           | Organization user id (usually equal to an ID on the customer side)                           |
| **user.organization\_user\_id\_type**                     | Type of organization user id (email, ...)                                                    |
| **user.proofs\_id**                                       | Id of proof document (for Preference Management Platform). Always null for user              |
| **user.source**                                           | Source of event. Always null for user object                                                 |
| **user.status**                                           | Status of the user. Always null for user object                                              |
| **user.updated\_at**                                      | Consent update date                                                                          |
| **user.validation**                                       | Payload for double opt-in consents (for Preference Management Platform)                      |
| **user.version**                                          | Number of modifications made to the user                                                     |
| **events.consents**                                       | Consents object for the event                                                                |
| **events.consents.channels**                              | Channels (for Preference Management Platform)                                                |
| **events.consents.channels.id**                           | Channel ID                                                                                   |
| **events.consents.channels.enabled**                      | User choices for the channel                                                                 |
| **events.consents.purposes**                              | Purposes (for both CMP and Preference Management Platform)                                   |
| **events.consents.purposes.enabled**                      | User choices for the purpose based on consent                                                |
| **events.consents.purposes.enabled\_li**                  | User choices for the purpose based on legitimate interest                                    |
| **events.consents.purposes.id**                           | Purpose ID                                                                                   |
| **events.consents.purposes.preferences**                  | Preferences (for Preference Management Platform)                                             |
| **events.consents.purposes.preferences.id**               | Preference ID                                                                                |
| **events.consents.purposes.preferences.enabled**          | User choices for the preference                                                              |
| **events.consents.purposes.preferences.channels**         | Purposes (for Preference Management Platform)                                                |
| **events.consents.purposes.preferences.channels.id**      | Channel ID linked to the purpose and preference                                              |
| **events.consents.purposes.preferences.channels.enabled** | User choice for the channel linked to the purpose and preference                             |
| **events.consents.tcfcs**                                 | TCF consent string generated by the user (for CMP)                                           |
| **events.consents.vendors**                               | Vendors object                                                                               |
| **events.consents.vendors.disabled**                      | List of vendors disabled by the user based on consent                                        |
| **events.consents.vendors.disabled\_li**                  | List of vendors disabled by the user based on legitimate interest                            |
| **events.consents.vendors.enabled**                       | List of vendors enabled by the user based on consent                                         |
| **events.consents.vendors.enabled\_li**                   | List of vendors enabled by the user based on legitimate interest                             |
| **events.country**                                        | Country of the user (always set by the client, null otherwise)                               |
| **events.created\_at**                                    | Creation date of the event                                                                   |
| **events.delegate**                                       | Information of the client's employee for signed consent (for Preference Management Platform) |
| **events.id**                                             | Event ID                                                                                     |
| **events.last\_seen\_country**                            | User country based on his last known connexion location                                      |
| **events.metadata**                                       | Metadata of user, defined by the customer                                                    |
| **events.organization\_id**                               | Didomi's organization ID                                                                     |
| **events.proofs\_id**                                     | Id of proof document (for Preference Management Platform). Always null for user              |
| **events.source**                                         | Source of event (for example SDK web...)                                                     |
| **events.status**                                         | Status of the user.                                                                          |
| **events.updated\_at**                                    | Consent update date                                                                          |
| **events.user**                                           | User object for the event                                                                    |
| **events.user.organization\_user\_id**                    | Organization user id (usually equal to an ID on the customer side)                           |
| **events.user.id**                                        | Didomi's user ID                                                                             |
| **events.user.metadata**                                  | Metadata of user, defined by the customer                                                    |
| **events.validation**                                     | Payload for double opt-in consents (for Preference Management Platform)                      |
| **events.version**                                        | Number of modifications made to the user                                                     |

### **👍 Batch export use cases**

Batch export can be useful for the following use cases:

* Compute consent metrics (dedicated documentation in progress) or metrics that are not provided by Didomi 
* Cross consent data with business data 
* Centralize or back up user choices in your system
* Reconcile data between you and Didomi (based on *organization\_user\_id*)
* Integrate data in your business tools (CRMs, marketing automation, etc.)
* Get proof of consent in case of complaints


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.didomi.io/integrations/generic-integrations/batch-export-content.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.