POST /webhooks/web/fetch_webhook_logs

Retrieve webhook delivery logs via the Dashboard API. Inspect payloads and delivery status to debug missed or failed webhook events.

Use this endpoint to retrieve a log of every webhook delivery attempt Shogun has made to your registered endpoint. Each log entry includes the event type, delivery status, the payload that was sent, and the response your server returned. This is the primary tool for debugging missed or failed event deliveries.

Endpoint

POST /api/v1/customer/web/fetch_webhook_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

filters · object · required

An object of filter criteria to scope the logs returned. At least one filter field is recommended to avoid retrieving the entire unscoped log.

Show filters fields

filters.event · string

Filter by the event type name (e.g., inflow.received, transfer.completed).

filters.status · string

Filter by delivery status (e.g., success, failed).

filters.transaction_id · string

Filter log entries associated with a specific transaction ID.

filters.webhook_id · string

Filter logs for a specific webhook configuration by its UUID.

Example Request Body

{
  "filters": {
    "status": "failed",
    "event": "inflow.received"
  }
}

Response

A successful response returns an array of webhook delivery log entries matching your filter criteria.

Field	Type	Description
id	string (uuid)	Unique identifier for this log entry
event	string	The event type that triggered the delivery attempt
status	string	Delivery outcome: success or failed
attempt	integer	Number of delivery attempts made for this event
payload	object	The JSON payload that was sent to your endpoint
response_body	string	The response body your endpoint returned
response_status_code	integer	HTTP status code your endpoint responded with
created_at	string (ISO 8601)	Timestamp when the delivery was attempted

Success

{
  "status": true,
  "response_code": "00",
  "message": "Success",
  "data": {
    "filters": {
      "logs": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "event": "inflow.received",
          "status": "failed",
          "attempt": 3,
          "payload": {
            "event": "inflow.received",
            "account_number": "7801234567",
            "amount": "5000.00"
          },
          "response_body": "Internal Server Error",
          "response_status_code": 500,
          "created_at": "2026-04-25T14:30:00Z"
        }
      ]
    }
  }
}

Example

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/customer/web/fetch_webhook_logs \
  --header 'Authorization: Bearer <your_dashboard_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "status": "failed",
      "event": "inflow.received"
    }
  }'