Skip to content
Navigation

Get analytics stats

GET
https://api.sureshake.com/v2/reports/{id}/analytics/stats

Path parameters

  • id
    string
    required
    format: uuid

Query parameters

  • period
    optional
    day
    or
    week
    or
    month
    default: "month"

Returns

200

Default Response

JSON
  • data
    object
    required
    • totalViews
      integer
      required
      minimum: 0
    • uniqueViewers
      integer
      required
      minimum: 0
    • anonymousViews
      integer
      required
      minimum: 0
    • viewsBySource
      object
      required
      • share
        integer
        required
        minimum: 0
      • vault
        integer
        required
        minimum: 0
      • direct
        integer
        required
        minimum: 0
      • api
        integer
        required
        minimum: 0
      • unknown
        integer
        required
        minimum: 0
    • audience
      object
      required
      • subject
        required

        Any of the following:

        • object
          • type
            personal
            required
          • id
            string
            required
            maxLength: 256 · minLength: 1
          • authorization
            authenticated_user
            required
          • actingContext
            personal
            required
        • object
          • type
            directory_listing
            required
          • id
            string
            required
            maxLength: 256 · minLength: 1
          • authorization
            current_directory_management_authority
            required
        • object
          • type
            entity
            required
          • id
            string
            required
            maxLength: 256 · minLength: 1
          • status
            compatibility_labeled
            required
          • authorization
            current_entity_owner
            required
        • object
          • type
            report
            required
          • id
            string
            required
            maxLength: 256 · minLength: 1
          • authorization
            report_owner_only
            required
      • source
        required

        Any of the following:

        • object
          • key
            directory_listing_views
            required
          • classification
            canonical
            required
          • recordAuthorities
            array of
            unknown
            required
          • readAuthorities
            array of
            unknown
            required
          • projectionAuthority
            object
            required
            • ordering
              events.stream_version
              required
            • receipts
              projection_event_receipts
              required
            • checkpoint
              projection_scoped_checkpoints
              required
            • lifecycle
              projection_lifecycles
              required
          • countingPolicy
            eligible_event
            required
          • countingEnforcement
            partial
            required
          • viewerHistory
            object
            required
            • availability
              unavailable
              required
            • timeAuthority
              first_viewed_at_only
              required
            • blocker
              last_view_watermark_required
              required
          • policyVersion
            directory-engagement-v1
            required
        • object
          • key
            compatibility_profile_views
            required
          • classification
            compatibility
            required
          • recordAuthority
            profile_views
            required
          • readAuthorities
            array of
            unknown
            required
          • countingPolicy
            deduplicated_24_hours
            required
          • countingEnforcement
            enforced
            required
          • viewerHistory
            object
            required
            • availability
              available
              required
            • timeAuthority
              latest_viewed_at
              required
          • policyVersion
            profile-views-v1
            required
        • object
          • key
            compatibility_entity_views
            required
          • classification
            compatibility
            required
          • recordAuthority
            entity_views
            required
          • readAuthorities
            array of
            unknown
            required
          • countingPolicy
            compatibility_source_owned
            required
          • countingEnforcement
            partial
            required
          • viewerHistory
            object
            required
            • availability
              available
              required
            • timeAuthority
              latest_viewed_at
              required
          • policyVersion
            entity-views-v1
            required
        • object
          • key
            report_views
            required
          • classification
            canonical
            required
          • recordAuthority
            document_views
            required
          • readAuthorities
            array of
            unknown
            required
          • countingPolicy
            idempotent_document_view
            required
          • countingEnforcement
            enforced
            required
          • viewerHistory
            object
            required
            • availability
              available
              required
            • timeAuthority
              latest_viewed_at
              required
            • attributionAuthority
              report_view_delivery_receipts.private_attribution
              required
          • idempotencyEnforcement
            object
            required
            • share
              enforced
              required
            • direct
              enforced
              required
            • vaultOrCollection
              enforced
              required
            • api
              enforced
              required
          • policyVersion
            report-views-v1
            required
      • period
        object
        required
        • key
          day
          or
          week
          or
          month
          or
          custom
          required
        • startAt
          string
          required
          format: date-time
        • endAt
          string
          required
          format: date-time
        • timezone
          UTC
          required
        • interval
          half_open
          required
        • asOf
          string
          required
          format: date-time
        • coverage
          event_window
          or
          snapshot
          or
          projection
          required
        • comparison
          object
          required
          • startAt
            string
            required
            format: date-time
          • endAt
            string
            required
            format: date-time
          • relationship
            immediately_preceding_equal_duration
            required
      • policy
        object
        required
        • identifiedViewer
          currently_authorized_owner_or_manager_only
          required
        • anonymousViewerHistory
          aggregate_only
          required
        • privateViewerHistory
          aggregate_only
          required
        • identityInference
          prohibited
          required
        • minimumBreakdownCohort
          5
          required
        • selfViews
          excluded
          required
        • activeBlocks
          bidirectional_write_and_read_exclusion
          required
        • blockRationaleDisclosure
          never
          required
        • privateBrowsing
          anonymous_aggregate_only
          required
        • returningViewers
          disabled
          required
        • enforcement
          object
          required
          • selfViews
            enforced
            or
            partial
            or
            pending
            required
          • activeBlocks
            enforced
            or
            partial
            or
            pending
            required
          • privateBrowsing
            enforced
            or
            partial
            or
            pending
            required
          • excludedTraffic
            enforced
            or
            partial
            or
            pending
            required
      • freshness
        object
        required
        • consistency
          read_time
          required
        • computedAt
          string
          required
          format: date-time
        • projectedThrough
          null
          or null
          required
        • lagMilliseconds
          null
          or null
          required
  • meta
    optional
    object
    • timestamp
      string
      required
      format: date-time

400

Default Response
JSON
  • error
    object
    required
    • code
      string
      required

      Machine-readable error code (e.g., NOT_FOUND)

    • message
      string
      required

      Human-readable error message

    • details
      optional
      unknown

      Optional structured error details

    • traceId
      optional
      string

      Unique ID for log correlation

401

Default Response
JSON
  • error
    object
    required
    • code
      string
      required

      Machine-readable error code (e.g., NOT_FOUND)

    • message
      string
      required

      Human-readable error message

    • details
      optional
      unknown

      Optional structured error details

    • traceId
      optional
      string

      Unique ID for log correlation

403

Default Response
JSON
  • error
    object
    required
    • code
      string
      required

      Machine-readable error code (e.g., NOT_FOUND)

    • message
      string
      required

      Human-readable error message

    • details
      optional
      unknown

      Optional structured error details

    • traceId
      optional
      string

      Unique ID for log correlation

404

Default Response
JSON
  • error
    object
    required
    • code
      string
      required

      Machine-readable error code (e.g., NOT_FOUND)

    • message
      string
      required

      Human-readable error message

    • details
      optional
      unknown

      Optional structured error details

    • traceId
      optional
      string

      Unique ID for log correlation

500

Default Response
JSON
  • error
    object
    required
    • code
      string
      required

      Machine-readable error code (e.g., NOT_FOUND)

    • message
      string
      required

      Human-readable error message

    • details
      optional
      unknown

      Optional structured error details

    • traceId
      optional
      string

      Unique ID for log correlation

Type to search…

↑↓ navigate↵ selectEsc close