> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List privacy-bounded session summaries

> Returns deterministic, cursor-paginated session summaries without detailed events, page sequences, full URLs, query strings, or fragments. `visitorId` is the lowercase SHA-256 value returned as `emailHash` by the visitor list and qualification endpoints. The signed cursor is bound to the organization, visitor, and timeframe. Sessions are ordered by start time and canonical session key, both descending.



## OpenAPI

````yaml https://api.aws53.cloud/openapi-data.json get /v1/data/visitors/{visitorId}/sessions
openapi: 3.1.0
info:
  title: Identification API
  version: 1.0.0
  description: >-
    Programmatic access to your visitor data and pixel management. Authenticate
    with your API key (X-API-Key header).
servers:
  - url: https://api.aws53.cloud
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Visitors
  - name: Pixels
  - name: Account
  - name: Visitor Suppression
paths:
  /v1/data/visitors/{visitorId}/sessions:
    get:
      tags:
        - Visitors
      summary: List privacy-bounded session summaries
      description: >-
        Returns deterministic, cursor-paginated session summaries without
        detailed events, page sequences, full URLs, query strings, or fragments.
        `visitorId` is the lowercase SHA-256 value returned as `emailHash` by
        the visitor list and qualification endpoints. The signed cursor is bound
        to the organization, visitor, and timeframe. Sessions are ordered by
        start time and canonical session key, both descending.
      parameters:
        - schema:
            type: string
            pattern: ^[A-Fa-f0-9]{64}$
            description: Visitor SHA-256 identifier from DataApiVisitor.emailHash
          required: true
          description: Visitor SHA-256 identifier from DataApiVisitor.emailHash
          name: visitorId
          in: path
        - schema:
            type: string
            enum:
              - 24h
              - 7d
              - 14d
              - 30d
              - 90d
              - all
            default: 30d
            description: Time window fixed when the first cursor page is requested
          required: false
          description: Time window fixed when the first cursor page is requested
          name: timeframe
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          required: false
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 1024
            description: >-
              Opaque signed nextCursor from the previous response. Do not
              construct or modify it
          required: false
          description: >-
            Opaque signed nextCursor from the previous response. Do not
            construct or modify it
          name: cursor
          in: query
      responses:
        '200':
          description: Bounded session summaries
          headers:
            RateLimit-Limit:
              description: Maximum requests in the current application rate-limit window
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests remaining in the current application rate-limit window
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current application rate-limit window resets
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiSessionSummaryPage'
        '400':
          description: Invalid visitor identifier or cursor
        '401':
          description: Missing or invalid API key
        '403':
          description: API key revoked or organization inactive
        '429':
          description: Rate limit exceeded
          headers:
            RateLimit-Limit:
              description: Maximum requests in the current application rate-limit window
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests remaining in the current application rate-limit window
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current application rate-limit window resets
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
        '503':
          description: Service unavailable
      security:
        - apiKeyAuth: []
components:
  schemas:
    DataApiSessionSummaryPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/DataApiSessionSummary'
        meta:
          type: object
          properties:
            limit:
              type: integer
            hasMore:
              type: boolean
            nextCursor:
              type:
                - string
                - 'null'
            timeframe:
              type: string
              enum:
                - 24h
                - 7d
                - 14d
                - 30d
                - 90d
                - all
              default: 30d
            asOf:
              type: string
              format: date-time
              description: >-
                Fixed traversal time carried by the signed cursor so relative
                timeframe boundaries do not move between pages
          required:
            - limit
            - hasMore
            - nextCursor
            - asOf
      required:
        - data
        - meta
    DataApiSessionSummary:
      type: object
      properties:
        sessionId:
          type: string
          description: >-
            Stable opaque identifier scoped to the organization, visitor, and
            canonical session bucket
          example: ses_1vR8zPqY2dV5hJ3mK7nB9cF4sT6wX0aL8eG2uN5iQ1o
        version:
          type: string
          description: >-
            Content fingerprint. Changes when any field in this bounded session
            summary changes
          example: sv_8sH2mN6qR1vY5cJ9kP3tW7xF0aD4eG8uL2bC6iQ1oZ5
        startTime:
          type: string
          format: date-time
        endTime:
          type: string
          format: date-time
        durationSeconds:
          type: integer
          minimum: 0
          description: >-
            Seconds between the first and latest event currently materialized
            for this session
        pageViews:
          type: integer
          minimum: 0
        entryPage:
          type:
            - string
            - 'null'
          description: >-
            Path-only entry page. Origin, query string, and fragment are never
            included
          example: /pricing
        exitPage:
          type:
            - string
            - 'null'
          description: >-
            Path-only latest page. Origin, query string, and fragment are never
            included
          example: /thank-you
        updatedAt:
          type: string
          format: date-time
          description: >-
            Time the canonical session summary was last materialized. Use
            version for content change detection
      required:
        - sessionId
        - version
        - startTime
        - endTime
        - durationSeconds
        - pageViews
        - entryPage
        - exitPage
        - updatedAt
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Organization API key (sk_...). Get yours from Settings > API Keys in the
        dashboard.

````