# Activity Logs

User activity log viewing endpoints

## List activity logs

> Returns activity logs for the authenticated user with pagination and filtering.

```json
{"openapi":"3.0.0","info":{"title":"PlainProxies API v2","version":"2.0.0"},"tags":[{"name":"Activity Logs","description":"User activity log viewing endpoints"}],"servers":[{"url":"https://dashboard.plainproxies.com/api/v2","description":"Production API Server"},{"url":"https://plainproxies-sandbox.com/api/v2","description":"Sandbox API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"API Key authentication. Get your key from the Dashboard Settings page. Include in all requests as: `X-API-KEY: PlainProxies_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`","name":"X-API-KEY","in":"header"}},"schemas":{"ActivityLog":{"properties":{"uuid":{"type":"string","format":"uuid"},"action":{"type":"string"},"module":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"ip_address":{"type":"string","nullable":true},"user_agent":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"changes":{"properties":{"old":{"type":"object","nullable":true},"new":{"type":"object","nullable":true}},"type":"object","nullable":true},"target":{"properties":{"id":{"type":"integer","nullable":true},"type":{"type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"}},"responses":{"Unauthorized":{"description":"Authentication failed. Ensure your API key is valid and included in the X-API-KEY header.","headers":{"WWW-Authenticate":{"description":"Authentication scheme hint","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"},"error":{"properties":{"code":{"type":"string","enum":["API_KEY_MISSING","INVALID_API_KEY","USER_NOT_FOUND"]},"message":{"type":"string"}},"type":"object"}},"type":"object"}}}}}},"paths":{"/activities":{"get":{"tags":["Activity Logs"],"summary":"List activity logs","description":"Returns activity logs for the authenticated user with pagination and filtering.","operationId":"95d85cd24fdf51e08dbfcdb7f894744e","parameters":[{"name":"filter[action]","in":"query","description":"Filter by action type","required":false,"schema":{"type":"string"}},{"name":"filter[module]","in":"query","description":"Filter by module","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number for pagination","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"per_page","in":"query","description":"Number of items per page (max 100)","required":false,"schema":{"type":"integer","default":20,"maximum":100,"minimum":1}},{"name":"include","in":"query","description":"Comma-separated list of additional data to include (changes, target)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of activity logs","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ActivityLog"}},"meta":{"properties":{"current_page":{"type":"integer"},"last_page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"from":{"type":"integer"},"to":{"type":"integer"}},"type":"object"}},"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Get activity log details

> Returns details for a specific activity log entry.

```json
{"openapi":"3.0.0","info":{"title":"PlainProxies API v2","version":"2.0.0"},"tags":[{"name":"Activity Logs","description":"User activity log viewing endpoints"}],"servers":[{"url":"https://dashboard.plainproxies.com/api/v2","description":"Production API Server"},{"url":"https://plainproxies-sandbox.com/api/v2","description":"Sandbox API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"API Key authentication. Get your key from the Dashboard Settings page. Include in all requests as: `X-API-KEY: PlainProxies_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`","name":"X-API-KEY","in":"header"}},"schemas":{"ActivityLog":{"properties":{"uuid":{"type":"string","format":"uuid"},"action":{"type":"string"},"module":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"ip_address":{"type":"string","nullable":true},"user_agent":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"changes":{"properties":{"old":{"type":"object","nullable":true},"new":{"type":"object","nullable":true}},"type":"object","nullable":true},"target":{"properties":{"id":{"type":"integer","nullable":true},"type":{"type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"}},"responses":{"Unauthorized":{"description":"Authentication failed. Ensure your API key is valid and included in the X-API-KEY header.","headers":{"WWW-Authenticate":{"description":"Authentication scheme hint","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"},"error":{"properties":{"code":{"type":"string","enum":["API_KEY_MISSING","INVALID_API_KEY","USER_NOT_FOUND"]},"message":{"type":"string"}},"type":"object"}},"type":"object"}}}},"NotFound":{"description":"The requested resource does not exist or you do not have access to it.","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}},"type":"object"}}}}}},"paths":{"/activities/{uuid}":{"get":{"tags":["Activity Logs"],"summary":"Get activity log details","description":"Returns details for a specific activity log entry.","operationId":"faa3768df25c8efbce528fbd8937c6b5","parameters":[{"name":"uuid","in":"path","description":"Activity log UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"include","in":"query","description":"Comma-separated list of additional data to include (changes, target)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Activity log details","content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/ActivityLog"}},"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.plainproxies.com/resller-api-documentation/account-and-logs/activity-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.