Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. V1
  5. System Events

System Events

markdownView as Markdown

Get internal Lytics system events. These events

are generally related to internal changes to state of

an account. Common changes are CRUD Operations (Create,

Update, Delete) of *Account*, *Admin User*, etc.

System Events Query

GEThttps://api.lytics.io/api/event

Get list of system events.

``

# get the dashboard news items

curl -s -H "Authorization: $LIOKEY" \

-XGET "https://api.lytics.io/api/event?query=dashboard_news" | jq '.'

# get list of all segments created in last 2 weeks

curl -s -H "Authorization: $LIOKEY" \

-XGET "https://api.lytics.io/api/event?type=segment&start=now-2w&limit=100&verb=created" | jq '.'

# get list of all events performed by user X

# 1) first find a user id

curl -s -H "Authorization: $LIOKEY" \

-XGET "https://api.lytics.io/api/user/[email protected]" | jq '.'

# 2) get the id for that user

curl -s -H "Authorization: $LIOKEY" \

-XGET "https://api.lytics.io/api/event?type=user&id=USER_ID_FROM_PREVIOUS" | jq '.'

``

Sample Response
Status|200 OK
123456789101112131415161718192021222324252627282930313233
{
  "data": [
    {
      "id": "13564999017e8b0e9994ff16411fd19b",
      "ts": "1465584982676",
      "priority": 2,
      "subject_type": "topic-document",
      "subject_id": "-1894399319812759219",
      "verb": "created",
      "account_id": "1234abcdefgh"
    },
    {
      "id": "c57172d7d22e1c7ac4c80ce713e6e7cb",
      "ts": "1465844458666",
      "priority": 2,
      "subject_type": "entity",
      "subject_id": "user/email/[email protected]",
      "verb": "clustered",
      "related": [
        {
          "type": "segment",
          "id": "791734b084019d99c82a475264464304"
        }
      ],
      "account_id": "1234abcdefgh",
      "context": {
        "in": "2016-06-13T18:58:29Z"
      }
    }
  ],
  "message": "success",
  "status": 200
}

System Event Fetch

GEThttps://api.lytics.io/api/event/:id

Get Single System Event

Sample Response
Status|200 OK
12345678910111213141516171819202122
{
  "data": {
    "id": "c57172d7d22e1c7ac4c80ce713e6e7cb",
    "ts": "1465844458666",
    "priority": 2,
    "subject_type": "entity",
    "subject_id": "user/email/[email protected]",
    "verb": "clustered",
    "related": [
      {
        "type": "segment",
        "id": "791734b084019d99c82a475264464304"
      }
    ],
    "account_id": "1234abcdefgh",
    "context": {
      "in": "2016-06-13T18:58:29Z"
    }
  },
  "message": "success",
  "status": 200
}
Hide Parameters

Query Parameters

account_idoptionalstring

Your Lytics account ID.

beforeoptionalstring

Start fetching items with dates older than: "now-3d" (now-2h, now-1w, "2016-03-03"). Date math, or absolute date.

afteroptionalstring

Start fetching items with dates after: "now-3d" (now-2h, now-1w, "2016-03-03"). Date math, or absolute date.

limitoptionalstring

Should segments this user is member of be included?

verboptionalstring

Verb (created, updated, deleted, status, clustered)

typeoptionalstring

Type of Object (entity, segment, work, account, user)

idoptionalstring

Id of Object (entity, segment, work, account, user)

Headers

Authorizationoptionalstring

Hide Parameters

Headers

Authorizationoptionalstring