POST /security/web/fetch_activity_logs

Retrieve API request logs for your Shogun Integration API usage. Filter by status, HTTP method, or date to diagnose integration issues.

Use this endpoint to retrieve a paginated record of every API request made through your Integration API credentials. Activity logs let you inspect the endpoint called, HTTP method used, response status, and the originating IP address — making it straightforward to diagnose failed requests, spot unexpected traffic, and monitor integration health.

Endpoint

POST /api/v1/security/web/fetch_activity_logs

Authentication

All requests must include a valid Dashboard Bearer token in the Authorization header.

Header	Type	Required	Description
Authorization	string	Yes	Bearer <token> — obtain from Login
Content-Type	string	Yes	application/json

Request Body

All parameters are optional. Omit the body entirely to retrieve the most recent activity log entries.

filters · object

An object of filter criteria to narrow results.

Show filters fields

filters.endpoint · string

Filter by the endpoint path (e.g., /api/v1/account/api/create_account).

filters.method · string

Filter by HTTP method. Accepted values: GET, POST.

filters.response_code · integer

Filter by HTTP response code (e.g., 200, 400, 401).

filters.status · string

Filter by outcome. Accepted values: success, error.

filters.ip_address · string

Filter by originating client IP address.

start_date · string

Return entries on or after this date. Format: YYYY-MM-DD.

end_date · string

Return entries on or before this date. Format: YYYY-MM-DD.

search · string

Free-text search term applied across log fields.

limit · integer

Maximum number of results to return. Defaults to 100.

cursor_created_at · string

ISO 8601 timestamp cursor for keyset pagination. Pass the created_at value of the last result from the previous page.

cursor_id · string

UUID cursor for keyset pagination. Pass the id of the last result from the previous page.

Example Request Body

{
  "filters": {
    "status": "error",
    "method": "POST"
  },
  "start_date": "2026-04-01",
  "end_date": "2026-04-28",
  "limit": 50
}

Response

Returns an array of ActivityLog entries matching your filter criteria.

Field	Type	Description
id	string (uuid)	Unique log entry identifier
endpoint	string	The API endpoint path that was called
method	string	HTTP method used (e.g., POST, GET)
response_code	integer	HTTP status code returned
status	string	Outcome: success or error
message	string	Response message associated with the request
ip_address	string	IP address that made the request
created_at	string (ISO 8601)	Timestamp when the request was recorded

Success

{
  "status": true,
  "response_code": "00",
  "message": "Success",
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "endpoint": "/api/v1/account/api/create_account",
      "method": "POST",
      "response_code": 400,
      "status": "error",
      "message": "Customer must be active to create additional accounts",
      "ip_address": "197.210.55.12",
      "created_at": "2026-04-15T08:42:00Z"
    }
  ]
}

Example

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/security/web/fetch_activity_logs \
  --header 'Authorization: Bearer <your_dashboard_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "status": "error",
      "method": "POST"
    },
    "start_date": "2026-04-01",
    "end_date": "2026-04-28",
    "limit": 50
  }'