--- title: Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Accounts](https://developers.cloudflare.com/api/python/resources/accounts) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Logs #### LogsAudit ##### [Get account audit logs (Version 2)](https://developers.cloudflare.com/api/python/resources/accounts/subresources/logs/subresources/audit/methods/list) accounts.logs.audit.list(AuditListParams\*\*kwargs) -> SyncCursorPaginationAfter\[[AuditListResponse]()] GET/accounts/{account\_id}/logs/audit ##### [Get resource change history from an account audit log entry (Version 2)](https://developers.cloudflare.com/api/python/resources/accounts/subresources/logs/subresources/audit/methods/history) accounts.logs.audit.history(strid, AuditHistoryParams\*\*kwargs) -> [AuditHistoryResponse]() GET/accounts/{account\_id}/logs/audit/{id}/history ##### [List account audit log product categories (Version 2)](https://developers.cloudflare.com/api/python/resources/accounts/subresources/logs/subresources/audit/methods/product_categories) accounts.logs.audit.product\_categories(AuditProductCategoriesParams\*\*kwargs) -> SyncSinglePage\[[AuditProductCategoriesResponse]()] GET/accounts/{account\_id}/logs/audit/product\_categories ##### ModelsExpand Collapse
class AuditListResponse: … id: Optional\[str] A unique identifier for the audit log entry. maxLength32 Link to this property
account: Optional\[Account] Contains account related information. id: Optional\[str] A unique identifier for the account. Link to this property name: Optional\[str] A string that identifies the account name. Link to this property
Link to this property
action: Optional\[Action] Provides information about the action performed. description: Optional\[str] A short description of the action performed. Link to this property result: Optional\[str] The result of the action, indicating success or failure. Link to this property time: Optional\[datetime] A timestamp indicating when the action was logged. formatdate-time Link to this property type: Optional\[str] A short string that describes the action that was performed. Link to this property
Link to this property
actor: Optional\[Actor] Provides details about the actor who performed the action. id: Optional\[str] The ID of the actor who performed the action. If a user performed the action, this will be their User ID. Link to this property
context: Optional\[Literal\["api", "api\_key", "api\_token", 3 more]] The context in which the action was initiated. - api: The action was performed through the API. The specific credential type was not recorded. - api_key: The action was authenticated with a Cloudflare Global API Key. - api_token: The action was authenticated with an API token. - dash: The action was performed through the Cloudflare dashboard. - oauth: The action was authenticated with an OAuth token. - origin_ca_key: The action was authenticated with an Origin CA key. One of the following: "api" Link to this property "api\_key" Link to this property "api\_token" Link to this property "dash" Link to this property "oauth" Link to this property "origin\_ca\_key" Link to this property
Link to this property email: Optional\[str] The email of the actor who performed the action. formatemail Link to this property ip\_address: Optional\[str] The IP address of the request that performed the action. Link to this property token\_id: Optional\[str] The API token ID when the actor context is an api\_token or oauth. Link to this property token\_name: Optional\[str] The API token name when the actor context is an api\_token or oauth. Link to this property
type: Optional\[Literal\["account", "cloudflare\_admin", "delegated\_service", 2 more]] The type of actor. One of the following: "account" Link to this property "cloudflare\_admin" Link to this property "delegated\_service" Link to this property "system" Link to this property "user" Link to this property
Link to this property
Link to this property
raw: Optional\[Raw] Provides raw information about the request and response. cf\_rayid: Optional\[str] The Cloudflare Ray ID for the request. Link to this property method: Optional\[str] The HTTP method of the request. Link to this property status\_code: Optional\[int] The HTTP response status code returned by the API. Link to this property uri: Optional\[str] The URI of the request. Link to this property user\_agent: Optional\[str] The client’s user agent string sent with the request. Link to this property
Link to this property
resource: Optional\[Resource] Provides details about the affected resource. id: Optional\[str] The unique identifier for the affected resource. Link to this property product: Optional\[str] The Cloudflare product associated with the resource. Link to this property request: Optional\[object] Link to this property response: Optional\[object] Link to this property scope: Optional\[object] The scope of the resource. Link to this property type: Optional\[str] The type of the resource. Link to this property
Link to this property
zone: Optional\[Zone] Provides details about the zone affected by the action. id: Optional\[str] A string that identifies the zone id. Link to this property name: Optional\[str] A string that identifies the zone name. Link to this property
Link to this property
[Link to this property](<#(resource)%20accounts.logs.audit%20%3E%20(model)%20audit_list_response%20%3E%20(schema)>)
List\[AuditHistoryResponseItem] id: Optional\[str] A unique identifier for the audit log entry. maxLength32 Link to this property
account: Optional\[AuditHistoryResponseItemAccount] Contains account related information. id: Optional\[str] A unique identifier for the account. Link to this property name: Optional\[str] A string that identifies the account name. Link to this property
Link to this property
action: Optional\[AuditHistoryResponseItemAction] Provides information about the action performed. description: Optional\[str] A short description of the action performed. Link to this property result: Optional\[str] The result of the action, indicating success or failure. Link to this property time: Optional\[datetime] A timestamp indicating when the action was logged. formatdate-time Link to this property type: Optional\[str] A short string that describes the action that was performed. Link to this property
Link to this property
actor: Optional\[AuditHistoryResponseItemActor] Provides details about the actor who performed the action. id: Optional\[str] The ID of the actor who performed the action. If a user performed the action, this will be their User ID. Link to this property
context: Optional\[Literal\["api", "api\_key", "api\_token", 3 more]] The context in which the action was initiated. - api: The action was performed through the API. The specific credential type was not recorded. - api_key: The action was authenticated with a Cloudflare Global API Key. - api_token: The action was authenticated with an API token. - dash: The action was performed through the Cloudflare dashboard. - oauth: The action was authenticated with an OAuth token. - origin_ca_key: The action was authenticated with an Origin CA key. One of the following: "api" Link to this property "api\_key" Link to this property "api\_token" Link to this property "dash" Link to this property "oauth" Link to this property "origin\_ca\_key" Link to this property
Link to this property email: Optional\[str] The email of the actor who performed the action. formatemail Link to this property ip\_address: Optional\[str] The IP address of the request that performed the action. Link to this property token\_id: Optional\[str] The API token ID when the actor context is an api\_token or oauth. Link to this property token\_name: Optional\[str] The API token name when the actor context is an api\_token or oauth. Link to this property
type: Optional\[Literal\["account", "cloudflare\_admin", "delegated\_service", 2 more]] The type of actor. One of the following: "account" Link to this property "cloudflare\_admin" Link to this property "delegated\_service" Link to this property "system" Link to this property "user" Link to this property
Link to this property
Link to this property
raw: Optional\[AuditHistoryResponseItemRaw] Provides raw information about the request and response. cf\_rayid: Optional\[str] The Cloudflare Ray ID for the request. Link to this property method: Optional\[str] The HTTP method of the request. Link to this property status\_code: Optional\[int] The HTTP response status code returned by the API. Link to this property uri: Optional\[str] The URI of the request. Link to this property user\_agent: Optional\[str] The client’s user agent string sent with the request. Link to this property
Link to this property
resource: Optional\[AuditHistoryResponseItemResource] Provides details about the affected resource. id: Optional\[str] The unique identifier for the affected resource. Link to this property product: Optional\[str] The Cloudflare product associated with the resource. Link to this property request: Optional\[object] Link to this property response: Optional\[object] Link to this property scope: Optional\[object] The scope of the resource. Link to this property type: Optional\[str] The type of the resource. Link to this property
Link to this property
zone: Optional\[AuditHistoryResponseItemZone] Provides details about the zone affected by the action. id: Optional\[str] A string that identifies the zone id. Link to this property name: Optional\[str] A string that identifies the zone name. Link to this property
Link to this property
[Link to this property](<#(resource)%20accounts.logs.audit%20%3E%20(model)%20audit_history_response%20%3E%20(schema)>)
class AuditProductCategoriesResponse: … A predefined product category and the resource products it expands to. label: Optional\[str] A human-readable label for the product category. Link to this property
products: Optional\[List\[Product]] The resource products that the product category expands to. label: Optional\[str] A human-readable label for the product. Link to this property value: Optional\[str] The resource\_product value that the product category expands to. Link to this property
Link to this property value: Optional\[str] The product category identifier used with the product\_category filter. Link to this property
[Link to this property](<#(resource)%20accounts.logs.audit%20%3E%20(model)%20audit_product_categories_response%20%3E%20(schema)>)