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

# Audit log

> Learn what audit log is, what data it includes, and how to use it in Voucherify

The **Audit log** gives you a full history of activity in your Voucherify project. You can use them to track API requests, user actions, and system processes.

The **Audit log** consists of:

* **Logs**: Lists API requests and responses. Use logs for troubleshooting and debugging.
* **Background tasks**: Lists asynchronous operations. Use this tab to monitor imports and system jobs like campaign or voucher updates.
* **Exports**: Lists exported data files. Use this to download and review data.
* **Webhook sendouts**: Lists webhook deliveries. Use this to track and retry webhook sendouts.

## Logs

<Info>
  <Badge color="gray">Data retention</Badge>

  **Logs** are stored for a limited time:

  * Shared clusters: 6 months
  * Dedicated clusters: 12 months
</Info>

Use **Logs** to troubleshoot API requests, check errors, and inspect request and response data.

Each time a request is sent to Voucherify (in the dashboard, through the API, or from an SDK), a log entry is created.

By default, logs display data from the last 24 hours. You can change the time range using filters. Use other filters to narrow down results.

Click a log ID to open detailed information about the API call, including its request and response in a JSON format.

If a log is related to a CSV import, you can download the original file used in the import.

<Tip>
  <Badge color="green">Export logs</Badge>

  You can export logs based on filters applied in the **Logs** tab.

  To export logs:

  1. Apply filters to narrow down results.
  2. Click **Export**.
  3. Download the file when it is ready.

  Larger exports may take longer to generate.

  <Badge color="green">Advanced filters (enterprise)</Badge>

  In addition to standard filters, you can narrow down the log results by text contained in the request or response body.
</Tip>

<Tip>
  <Badge color="green">Example: Investigating a failed request</Badge>

  To investigate a failed request:

  1. Go to the **Logs** tab.
  2. Filter by **Status**: **Failure**.
  3. Open the log ID.
  4. Review the request and response details.
</Tip>

## Background tasks

Use **Background tasks** to monitor long-running operations such as imports, exports, or campaign updates. Asynchronous actions triggered through the API also appear here. You can see if the task is enqueued, in progress, done, or failed. **Background tasks** are stored indefinitely.

Click a task ID to view detailed information about the operation.

Use filters to narrow down results.

## Exports

Use **Exports** to list, manage, and download exported data files. It shows the history of generated export files.

Click an export ID to view details such as applied filters and parameters.

Use filters to narrow down results.

<Tip>
  <Badge color="green">API log export: Dashboard browser</Badge>

  For API log exports, you can open the file directly in Voucherify without downloading the file.

  Click **Browse data** on a ready export to open it in a browser view. This may take a moment to load. The data is displayed for the columns selected during the export.

  Use the browser to search across the dataset or open the request and response bodies as JSONs.

  Use filters to narrow down results.

  Browsing is available only for:

  * API log exports.
  * Files ready for download.
  * Files not older than 90 days.
</Tip>

## Webhook sendouts

Use **Webhook sendouts** to track webhook delivery. You can check if the webhook has been sent successfully, is being retried, or has failed.

Click the three-dot **⋮** menu to:

* See the sent data in the JSON format.
* See error (if any).
* Retry the sendout.

Use filters to narrow down results.

## Related features

Explore other features that complement audit logs when monitoring, debugging, and exporting project activity.

<AccordionGroup>
  <Accordion title="Webhooks">
    Use webhooks to receive event notifications in your application instead of searching the audit logs. The **Webhook sendouts** tab shows the delivery history of these webhooks.

    Learn more about webhooks:

    * [Introduction to Voucherify webhooks](/api-reference/introduction-to-webhooks): Overview of project- and distribution-level webhooks.
    * [Project settings webhooks](/api-reference/project-settings-webhooks): Configure webhooks for project events such as redemptions, customer changes, or order updates.
    * [Distribution webhooks](/api-reference/distribution-webhooks): Configure webhooks for distribution events such as voucher publication and message delivery.
  </Accordion>

  <Accordion title="Exports: API">
    The **Exports** tab lists files generated from the dashboard or through the API. Use the export API to trigger and download exports programmatically.

    Learn more about the export API:

    * [Export object](/api-reference/exports/export-object): Structure of the export resource.
    * [Create export](/api-reference/exports/create-export): Start a new export job.
    * [List exports](/api-reference/exports/list-exports): Retrieve all exports in your project.
    * [Get export](/api-reference/exports/get-export): Check the status and result of an export.
    * [Download export](/api-reference/exports/download-export): Download the generated file.
    * [CSV export with API](/guides/csv-export): Guide to exporting vouchers, redemptions, publications, and customers through the API.
  </Accordion>

  <Accordion title="Imports and background tasks">
    The **Background tasks** tab tracks the progress of long-running jobs such as imports and bulk updates.

    Learn more about imports:

    * [Customer import](/prepare/customers#data-import-and-synchronization)
    * [Product import](/prepare/products#bulk-import-with-csv)
    * [Discount code import](/build/discount-code-import)
    * [Gift card import](/build/gift-card-import)
    * [Loyalty card import](/build/loyalty-card-import)
    * [Referral code import](/build/referral-code-import)
  </Accordion>

  <Accordion title="API and developer tools">
    Use these resources to correlate audit log entries with your integration code:

    * [API overview](/guides/api-overview): Authentication, rate limits, and request structure.
    * [Management API](/guides/management-api): Manage projects, users, and resources programmatically.
    * [Limits](/guides/limits): API rate limits and quotas that may surface as failed requests in the logs.
  </Accordion>

  <Accordion title="Developer setup: Background tasks and async actions API">
    You can use **Background tasks** in combination with the following async actions endpoints:

    * [List async actions](/api-reference/async-actions/list-async-actions)
    * [Get async action](/api-reference/async-actions/get-async-action)

    Use these endpoints to track the progress and status of all async actions or get details about the result of a specific async action, for example for debugging.
  </Accordion>
</AccordionGroup>