> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/commerce-openapis/data-warehouse/audit-events.md).

# Audit Events

## GET /audit-events/

> This method returns details about an audit event, including the event's UUID, user information (email, name), timestamp, IP address, accessed URL, query parameters, post data, and request headers. Audit events are used to track user actions and system changes for security and compliance purposes.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Omnitron Remote Proxy (external access - recommended)","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com","description":"Omnitron server URL."}}},{"description":"Commerce API Server (internal / direct access only)","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Internal Commerce API URL. Not reachable directly by external clients; use the Omnitron proxy server above."}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"PaginatedEventList":{"properties":{"count":{"description":"Numerical value representing quantity or total amount.","type":"integer"},"next":{"description":"This field defines the URL of the next page.","format":"uri","nullable":true,"type":"string"},"previous":{"description":"This field defines the URL of the previous page.","format":"uri","nullable":true,"type":"string"},"results":{"description":"This field returns a list of results.","items":{"$ref":"#/components/schemas/Event"},"type":"array"}},"type":"object"},"Event":{"properties":{"content":{"description":"This field defines the content or details of the event, typically the data or change made."},"content_type":{"description":"The classification or type related to this field.","type":"integer"},"headers":{"description":"This field defines the HTTP headers sent along with the request, which can include metadata about the request.","nullable":true},"object_id":{"description":"This field defines the unique identifier of the object being affected by the event.","maximum":2147483647,"minimum":0,"type":"integer"},"post_data":{"description":"This field defines the data sent by the client in the HTTP POST request.","nullable":true},"query_params":{"description":"This field defines the query parameters included in the URL during the request.","nullable":true},"remote_addr":{"description":"This field defines the IP address of the client making the request.","nullable":true,"title":"IP adresi","type":"string"},"timestamp":{"description":"This field defines the exact date and time when the event occurred.","format":"date-time","type":"string"},"url":{"description":"This field defines the URL that the client accessed during the event.","format":"uri","maxLength":1000,"nullable":true,"type":"string"},"user":{"$ref":"#/components/schemas/User","description":"This field defines the user who triggered the event."},"uuid":{"description":"Unique identifier for the record.","format":"uuid","title":"ID","type":"string"}},"type":"object"},"User":{"properties":{"attributes":{"description":"This field defines a dictionary containing the user's attributes.","type":"string"},"attributes_kwargs":{"description":"This field defines a dictionary containing the user's attributes.","type":"string"},"avatar":{"description":"This field defines the user's photo.","type":"string"},"call_allowed":{"description":"This field defines the user's call communication consent.","type":"string"},"date_joined":{"description":"This field defines the creation date.","type":"string"},"date_of_birth":{"description":"This field defines the user's birthday.","type":"string"},"email":{"description":"Email address of the user or entity.","format":"email","maxLength":254,"title":"E-posta adresi","type":"string"},"email_allowed":{"description":"This field defines the user's email communication consent.","type":"string"},"first_name":{"description":"The full name or label associated with the record.","maxLength":150,"title":"Adı","type":"string"},"gender":{"description":"This field defines the user's gender. Possible values are: **male**, **female**, **not_to_say**","type":["string","null"]},"groups":{"description":"This field defines the permission groups to which the user is added.","type":"string"},"id":{"description":"This field defines the database ID of the record.","type":"string"},"is_active":{"description":"This field defines whether the user is active.","type":"string"},"is_anonymized":{"description":"This field defines whether the user has been anonymized.","type":"string"},"is_staff":{"description":"This field defines whether the user is a staff.","type":"string"},"is_superuser":{"description":"This field defines whether the user is a super user.","type":"string"},"language_code":{"description":"This field defines the user's local language.","type":"string"},"last_login":{"description":"This field defines the date of the user's last login.","type":"string"},"last_name":{"description":"The full name or label associated with the record.","maxLength":150,"title":"Soyadı","type":"string"},"localized_attributes":{"description":"This field defines a dictionary containing translations of the user's attributes based on the language.","type":"string"},"localized_attributes_kwargs":{"description":"This field defines a dictionary containing translations of the user's attributes based on the language.","type":"string"},"modified_date":{"description":"This field defines the last updated date.","type":"string"},"phone":{"description":"This field defines the user's phone number.","type":"string"},"pk":{"title":"ID","type":"integer"},"sms_allowed":{"description":"This field defines the user's SMS communication consent.","type":"string"},"user_permissions":{"description":"This field defines the user’s permissions.","type":"string"},"user_type":{"description":"This field defines the user type. Possible values are: **guest**, **registered**","type":"string"},"username":{"description":"This field defines the username.","type":"string"}},"type":"object"}}},"paths":{"/audit-events/":{"get":{"description":"This method returns details about an audit event, including the event's UUID, user information (email, name), timestamp, IP address, accessed URL, query parameters, post data, and request headers. Audit events are used to track user actions and system changes for security and compliance purposes.","operationId":"audit_events_list","parameters":[{"description":"Query parameter `content_type` used to filter results based on specific conditions.","in":"query","name":"content_type","schema":{"type":"integer"}},{"description":"Limits the number of records returned in a single page. The maximum is 1000. A higher value is capped at 1000 and the request still succeeds.","in":"query","name":"limit","required":false,"schema":{"maximum":1000,"type":"integer"}},{"description":"Query parameter `object_id` used to filter results based on specific conditions.","in":"query","name":"object_id","schema":{"type":"integer"}},{"description":"Query parameter `page` used to filter results based on specific conditions.","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Query parameter `sort` used to filter results based on specific conditions.","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"Query parameter `timestamp` used to filter results based on specific conditions.","in":"query","name":"timestamp","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `timestamp` is greater than the given value.","in":"query","name":"timestamp__gt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `timestamp` is greater than or equal to the given value.","in":"query","name":"timestamp__gte","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `timestamp` is less than the given value.","in":"query","name":"timestamp__lt","schema":{"format":"date-time","type":"string"}},{"description":"Filters records where `timestamp` is less than or equal to the given value.","in":"query","name":"timestamp__lte","schema":{"format":"date-time","type":"string"}},{"description":"Query parameter `user` used to filter results based on specific conditions.","in":"query","name":"user","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedEventList"}}},"description":"Successful response for status code 200."}},"tags":["audit-events"]}}}}
```

## GET /audit-events/{uuid}/

> This method returns details about an audit event, including the event's UUID, user information (email, name), timestamp, IP address, accessed URL, query parameters, post data, and request headers. Audit events are used to track user actions and system changes for security and compliance purposes. This endpoint retrieves a specific record by its unique identifier.

```json
{"openapi":"3.0.3","info":{"title":"Data Warehouse","version":"1.0.0"},"servers":[{"description":"Omnitron Remote Proxy (external access - recommended)","url":"https://{omnitron_url}/api/v1/remote/{channel_id}/data-warehouse","variables":{"channel_id":{"default":"1","description":"Unique identifier for the sales channel."},"omnitron_url":{"default":"sandbox.akinon.com","description":"Omnitron server URL."}}},{"description":"Commerce API Server (internal / direct access only)","url":"https://{commerce_url}/api/v1/data-warehouse","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Internal Commerce API URL. Not reachable directly by external clients; use the Omnitron proxy server above."}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"description":"Token-based authentication with required prefix \"Token\"","in":"header","name":"Authorization","type":"apiKey"}},"schemas":{"Event":{"properties":{"content":{"description":"This field defines the content or details of the event, typically the data or change made."},"content_type":{"description":"The classification or type related to this field.","type":"integer"},"headers":{"description":"This field defines the HTTP headers sent along with the request, which can include metadata about the request.","nullable":true},"object_id":{"description":"This field defines the unique identifier of the object being affected by the event.","maximum":2147483647,"minimum":0,"type":"integer"},"post_data":{"description":"This field defines the data sent by the client in the HTTP POST request.","nullable":true},"query_params":{"description":"This field defines the query parameters included in the URL during the request.","nullable":true},"remote_addr":{"description":"This field defines the IP address of the client making the request.","nullable":true,"title":"IP adresi","type":"string"},"timestamp":{"description":"This field defines the exact date and time when the event occurred.","format":"date-time","type":"string"},"url":{"description":"This field defines the URL that the client accessed during the event.","format":"uri","maxLength":1000,"nullable":true,"type":"string"},"user":{"$ref":"#/components/schemas/User","description":"This field defines the user who triggered the event."},"uuid":{"description":"Unique identifier for the record.","format":"uuid","title":"ID","type":"string"}},"type":"object"},"User":{"properties":{"attributes":{"description":"This field defines a dictionary containing the user's attributes.","type":"string"},"attributes_kwargs":{"description":"This field defines a dictionary containing the user's attributes.","type":"string"},"avatar":{"description":"This field defines the user's photo.","type":"string"},"call_allowed":{"description":"This field defines the user's call communication consent.","type":"string"},"date_joined":{"description":"This field defines the creation date.","type":"string"},"date_of_birth":{"description":"This field defines the user's birthday.","type":"string"},"email":{"description":"Email address of the user or entity.","format":"email","maxLength":254,"title":"E-posta adresi","type":"string"},"email_allowed":{"description":"This field defines the user's email communication consent.","type":"string"},"first_name":{"description":"The full name or label associated with the record.","maxLength":150,"title":"Adı","type":"string"},"gender":{"description":"This field defines the user's gender. Possible values are: **male**, **female**, **not_to_say**","type":["string","null"]},"groups":{"description":"This field defines the permission groups to which the user is added.","type":"string"},"id":{"description":"This field defines the database ID of the record.","type":"string"},"is_active":{"description":"This field defines whether the user is active.","type":"string"},"is_anonymized":{"description":"This field defines whether the user has been anonymized.","type":"string"},"is_staff":{"description":"This field defines whether the user is a staff.","type":"string"},"is_superuser":{"description":"This field defines whether the user is a super user.","type":"string"},"language_code":{"description":"This field defines the user's local language.","type":"string"},"last_login":{"description":"This field defines the date of the user's last login.","type":"string"},"last_name":{"description":"The full name or label associated with the record.","maxLength":150,"title":"Soyadı","type":"string"},"localized_attributes":{"description":"This field defines a dictionary containing translations of the user's attributes based on the language.","type":"string"},"localized_attributes_kwargs":{"description":"This field defines a dictionary containing translations of the user's attributes based on the language.","type":"string"},"modified_date":{"description":"This field defines the last updated date.","type":"string"},"phone":{"description":"This field defines the user's phone number.","type":"string"},"pk":{"title":"ID","type":"integer"},"sms_allowed":{"description":"This field defines the user's SMS communication consent.","type":"string"},"user_permissions":{"description":"This field defines the user’s permissions.","type":"string"},"user_type":{"description":"This field defines the user type. Possible values are: **guest**, **registered**","type":"string"},"username":{"description":"This field defines the username.","type":"string"}},"type":"object"}}},"paths":{"/audit-events/{uuid}/":{"get":{"description":"This method returns details about an audit event, including the event's UUID, user information (email, name), timestamp, IP address, accessed URL, query parameters, post data, and request headers. Audit events are used to track user actions and system changes for security and compliance purposes. This endpoint retrieves a specific record by its unique identifier.","operationId":"audit_events_retrieve","parameters":[{"description":"A UUID string identifying this Audit event.","in":"path","name":"uuid","required":true,"schema":{"format":"uuid","title":"ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}},"description":"Successful response for status code 200."}},"tags":["audit-events"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://apidocs.akinon.com/commerce-openapis/data-warehouse/audit-events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.