# Audits

Audit logs are created when enabled on calculation requests.

| ℹ️ To use this feature you need to have it enabled for your account, please contact us for more information.|
|------------------------------------------------------------------------------------------------------------|

<br>
When Audit mode is enabled for a client, SQUAKE will generate audit logs if it's requested within the calculations request body. These logs are immutable; once they are created they cannot be altered—please use this feature only for final calculations.

Operational notes:
- Use **audit mode** whenever a calculation is for **past activity / post-booking (post-validated)** (e.g., ticketed & already-flown flights, completed stays/trips, historical backfills, invoice reconciliation/true-ups, corrections). These records are final and must be immutable.
- **Audit mode must not be used for future-looking / pre-booking** or other non-final use cases (e.g., shopping/quotes, draft or tentative itineraries, forecasting/scenario planning, preliminary estimates, or POS value requests). These are expected to change.
- **Post-booking (finalized) calculations MUST be performed with audit mode enabled.**
- **Pre-booking (non-audit) calculated values must not be carried over into post-booking reporting**; after the activity is finalized, the calculation must be re-run with audit mode enabled.
- Requests that handle **points-of-sale (POS) values** or other preview/estimation-only calls MUST be sent **without** audit mode.

Rule of thumb: **Past/post-validated = audit mode; Future/pre-booking = no audit mode**.

If you are calculating on behalf of a legal entity, you can create an Auditable entity via the [/v2/audits/entities](https://docs-v2.squake.earth/docs/openapi/audits/post-v2-audits-entities) endpoint and use the ID from the response as the `audit_for` property in the calculation request. This will associate all audit logs created for that calculation with the given Auditable entity.


## Retrieve the list of Audit logs

 - [GET /v2/audits](https://docs-v2.squake.earth/docs/openapi/audits/get-v2-audits.md): Retrieve the list of audit logs for the authenticated client


## Retrieve a specific Audit log

 - [GET /v2/audits/{id}](https://docs-v2.squake.earth/docs/openapi/audits/get-v2-audits-id.md): Retrieves detailed information about a specific Audit log


## Retrieve the list of Auditable entities

 - [GET /v2/audits/entities](https://docs-v2.squake.earth/docs/openapi/audits/get-v2-audits-entities.md): Retrieve the list of Auditable entities, which can be used for auditing


## Create a new Auditable entity

 - [POST /v2/audits/entities](https://docs-v2.squake.earth/docs/openapi/audits/post-v2-audits-entities.md): Create a new Auditable entity, which can be used for auditing


## Retrieve a specific Auditable entity

 - [GET /v2/audits/entities/{id}](https://docs-v2.squake.earth/docs/openapi/audits/get-v2-audits-entities-id.md): Retrieve a specific Auditable entity