GET/api/v1/events

List Ingested Events Log

Query and audit all historical business events ingested into Softymize. Filter by status, event type, date range, or customer phone number.

Query Parameters

Parameter	Type	Default	Description
event	string	-	Filter by event name (e.g. `order.created`, `cart.abandoned`)
status	string	all	Filter by processing state: `pending` \| `processed` \| `failed`
phone	string	-	Filter by customer E.164 phone number (e.g. `+919876543210`)
limit	integer	20	Number of records per page (max 100)

cURL Example Request

HTTP GET Request ExamplecURL

curl -X GET "https://api.softymize.com/api/v1/events?event=order.created&status=processed&limit=20" \
  -H "X-Softymize-API-Key: sk_prod_igpsus_9f8a3c4b12d34e5f"

JSON Response Body

Success Response (HTTP 200 OK)JSON

{
  "success": true,
  "message": "Ingested events retrieved successfully.",
  "data": [
    {
      "event_id": "evt_9f8a3c4b12d34e5f",
      "event": "order.created",
      "event_category": "commerce",
      "status": "processed",
      "customer": {
        "name": "Rohan Sharma",
        "phone": "+919876543210",
        "email": "[email protected]"
      },
      "data": {
        "order_id": "ORD-100293",
        "total": "1499.00"
      },
      "received_at": "2026-07-25T12:35:10Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "request_id": "req_8a1b2c3d4e5f6g7h"
  }
}

← POST /api/v1/events Reference Outgoing Webhooks →