1. Customer Events
TrustWILL
  • Reviews Widget Integration
  • Reviews Data API
    • Trustoo Open API — Quick Start
    • OAuth2
      • OAuth2 Merchant Authorization
      • Get OAuth2 Authorization URL
      • OAuth2 Get / Refresh Access Token
      • Revoke Token
    • Platform Management
      • Disconnect Platform Authorization
      • Get Shop Authorization Info
      • Get Shop Installation Status
      • Cancel Platform Authorization
    • Webhooks
      • Create Shop Webhook
      • Update Shop Webhook
      • Delete Shop Webhook
      • Get Shop Webhooks
    • Reviews
      • Get Review Detail
      • Get Review List
      • Create Review
      • Delete Review
      • Get Rating
    • Media Upload
      • Get Video Upload URL
      • Get Image Upload Credentials
    • Orders
      • Get Order List
    • Customer Events
      • Get Customer Event List
        GET
    • Customers
      • Email Unsubscribe
      • Create Customer Exclusion
      • Delete Customer Exclusion
      • Get Customer Exclusion List
  • Schemas
    • SuccessResponse
    • ErrorResponse
    • Pagination
    • OAuthTokenRequest
    • Webhook
    • CreateReviewRequest
    • Review
    • Rating
    • Order
    • CustomerEvent
    • CustomerExclusion
    • ImageUploadCredentials
  1. Customer Events

Get Customer Event List

GET
/api/v1/openapi/get_customer_events
Query customer interaction events (clicks, views, submissions, filtering, sorting, media interactions, etc.) with filtering and pagination.
Authentication: HMAC signature OR OAuth2 Bearer Token
Scope: read_customer_events

Request

Authorization
API Key
Add parameter in header
Public-Token
Example:
Public-Token: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://rapi.trustoo.io/api/v1/openapi/get_customer_events?event_type=CLICK_MEDIA&os_type=undefined&event_source=undefined&device_type=undefined&start_time=undefined&end_time=undefined&sort_by=created-ascending&page_size=20&page=1' \
--header 'Sign: 31ff687ec862dbf14cb1a75407e1681b5bde64feb350f545c22f69c095ddbaba' \
--header 'Timestamp: 1779678340' \
--header 'Public-Token: <api-key>'

Responses

🟢200
application/json
Paginated customer event list
Bodyapplication/json

Example
{
    "code": 0,
    "message": "string",
    "time": 0,
    "request_id": "string",
    "data": {
        "page": {
            "page": 0,
            "page_size": 0,
            "total_page": 0,
            "count": 0
        },
        "list": [
            {
                "id": "string",
                "client_id": "string",
                "event_type": "string",
                "event_source": "string",
                "device_type": "string",
                "os_type": "string",
                "page_url": "string",
                "created_at": "string",
                "properties": "string"
            }
        ]
    }
}
Modified at 2026-06-24 04:25:21
Previous
Get Order List
Next
Email Unsubscribe
Built with