Events
Event-level analytics and segmentation
Get Event Time Series
Returns daily event and user counts for a supported SkinAI event key.
Get Event Segmentation
Returns event counts and user counts grouped by a requested event segmentation key. This route is limited to 31 days.
List Events
Returns raw events newest first, one row per event, with the `partner_analytics_id` the plugin attached (or `null`). Filter by `partner_analytics_id` to read back one partner user's events. Follow `meta.next_cursor` with the same filters until it is `null`. Limited to 31 days inside the raw retention window (about 3 complete months plus the current month); older ranges return 422. Events sent before the id was set are not linked. `onQuestionnaireComplete` answers come with the question and answer text from the current Studio quiz (`null` once deleted). `onSkinScoreCalculate` carries the `analysisId` also sent in the SDK event. Product and routine ids are internal and can change; each comes with its slug (your SKU), e.g. `product_id` + `product_slug`, `productIds` + `productSlugs` in the same order. The slug is the one recorded when the event happened, else the current catalog slug, else `null` (no longer in this app's catalog). Match on the slug, case-insensitively.
List Diagnoses
Returns one row per skin analysis (`onSkinScoreCalculate`), newest first, with the quiz answers and recommendations of the same session already attached: the latest quiz at or before the analysis (a retake reuses it) and the recommendations nearest to it. `questionnaire` is `null` when no quiz was taken, and labels come from the current Studio quiz (`null` once deleted). Same filters, paging, 31-day limit and retention window as `GET /v1/apps/{app_key}/events`.