> For the complete documentation index, see [llms.txt](https://docs.dovu.earth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dovu.earth/workflow-engine/editor/audit-trails.md).

# Audit Trails

Audit trails play a critical role in ensuring transparency, compliance, and trust within the DOVU OS system. By providing a detailed record of every action and event associated with a workflow instance, these trails form the backbone of provenance tracking. Whether for visualizing credits in a marketplace or generating compliance reports, audit trails offer the insights needed to validate the integrity of credits.

**Key Benefits**

1. **End-to-End Provenance**:\
   Track the entire lifecycle of a credit, from its creation to issuance, transfer, and beyond. This ensures that every step in the workflow is fully traceable.
2. **Marketplace Visualization**:\
   Enable third-party marketplaces or platforms to display the complete journey of a credit, giving buyers and stakeholders confidence in its authenticity and impact.
3. **Compliance and Reporting**:\
   Provide detailed records to meet regulatory requirements or demonstrate adherence to industry standards. This is especially valuable for sustainability-focused projects.
4. **Seamless Integration**:\
   Use the audit trail data to integrate with front-end visualizations, dashboards, or external systems, enabling easy consumption of the provenance data.

***

**How It Works**

* The **Get Workflow Instance Audit Trail** endpoint retrieves a chronological list of actions, events, and associated metadata for a specific workflow instance.
* Each audit trail entry captures key information such as timestamps, user actions, workflow transitions, and schema updates.
* The endpoint supports structured responses, including pagination and links for navigating large datasets.

***

{% openapi src="/files/6mJSP7xbb1mnOT7LWsQy" path="/api/v1/workflow-instances/workflow\_instance\_id/audit-trail" method="get" %}
[DOVU OS.openapi(1).yaml](https://116257023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMgfYR4iNMhdWqFrJ1ibn%2Fuploads%2Fp3lUNEaW0nFPV2ZCMt2b%2FDOVU%20OS.openapi\(1\).yaml?alt=media\&token=2b22f069-e425-4f40-8e6d-176ba0f1db49)
{% endopenapi %}