--- title: Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Organizations](https://developers.cloudflare.com/api/python/resources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Logs #### LogsAudit ##### [Get organization audit logs (Version 2)](https://developers.cloudflare.com/api/python/resources/organizations/subresources/logs/subresources/audit/methods/list) organizations.logs.audit.list(strorganization\_id, AuditListParams\*\*kwargs) -> SyncCursorPaginationAfter\[[AuditListResponse]()] GET/organizations/{organization\_id}/logs/audit ##### [Get resource change history from an organization audit log entry (Version 2)](https://developers.cloudflare.com/api/python/resources/organizations/subresources/logs/subresources/audit/methods/history) organizations.logs.audit.history(strid, AuditHistoryParams\*\*kwargs) -> [AuditHistoryResponse]() GET/organizations/{organization\_id}/logs/audit/{id}/history ##### ModelsExpand Collapse
class AuditListResponse: … id: Optional\[str] A unique identifier for the audit log entry. maxLength32 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\["cloudflare\_admin", "system", "user"]] The type of actor. One of the following: "cloudflare\_admin" Link to this property "system" Link to this property "user" Link to this property
Link to this property
Link to this property
organization: Optional\[Organization] Contains organization related information. id: Optional\[str] A unique identifier for the organization. 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
[Link to this property](<#(resource)%20organizations.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
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\["cloudflare\_admin", "system", "user"]] The type of actor. One of the following: "cloudflare\_admin" Link to this property "system" Link to this property "user" Link to this property
Link to this property
Link to this property
organization: Optional\[AuditHistoryResponseItemOrganization] Contains organization related information. id: Optional\[str] A unique identifier for the organization. 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
[Link to this property](<#(resource)%20organizations.logs.audit%20%3E%20(model)%20audit_history_response%20%3E%20(schema)>)