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

# List Person Events

> Returns page views, clicks, and scroll events for a specific person



## OpenAPI

````yaml GET /v1/people/{id}/events
openapi: 3.0.3
info:
  title: Maverick Intelligence API
  description: >
    Programmatic access to your Maverick Intelligence data — identified website
    visitors,

    companies, events, and analytics.


    ## Authentication

    All endpoints (except `/v1/health`) require an API key passed in the
    `X-API-Key` header.


    ```bash

    curl -H "X-API-Key: mk_live_your_key_here"
    https://api-v1.maverickintelligence.co/v1/people

    ```


    ## Rate Limiting

    - **1,000 requests per hour** per customer (shared across all API keys)

    - Every response includes `X-RateLimit-Limit` and `X-RateLimit-Remaining`
    headers

    - When exceeded, you'll receive a `429` response with a `Retry-After` header


    ## Pagination

    List endpoints use cursor-based pagination. Pass the `nextCursor` from the
    response

    as the `cursor` query parameter to fetch the next page.


    ## Sorting

    Results are always sorted by most recently seen first (`lastSeen`
    descending).

    Custom sorting is not yet supported — passing a `sort` or `order` query

    parameter returns `400 bad_request`. Custom sorting options will be
    available

    in a future version.
  version: 1.0.0
  contact:
    name: Maverick Intelligence Support
    email: nick@maverickintelligence.co
    url: https://maverickintelligence.co
servers:
  - url: https://api-v1.maverickintelligence.co
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: System
    description: API health and status
  - name: People
    description: Identified website visitors
  - name: Events
    description: Behavioral events (page views, clicks, scrolls)
  - name: Companies
    description: Companies identified from visitors
  - name: Statistics
    description: Aggregate analytics
paths:
  /v1/people/{id}/events:
    get:
      tags:
        - Events
      summary: List person events
      description: |
        Returns page views, clicks, and scroll events for a specific person.
        Results are sorted by most recent first.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Person ID
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
      responses:
        '200':
          description: List of events
          content:
            application/json:
              schema:
                type: object
                properties:
                  person:
                    type: object
                    description: Summary of the person these events belong to
                    properties:
                      id:
                        type: string
                      firstName:
                        type: string
                        nullable: true
                      lastName:
                        type: string
                        nullable: true
                      email:
                        type: string
                        nullable: true
                      company:
                        type: string
                        nullable: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Event'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
        '404':
          description: Person not found
components:
  parameters:
    limit:
      name: limit
      in: query
      schema:
        type: integer
        default: 50
        minimum: 1
        maximum: 100
      description: Number of records per page
    cursor:
      name: cursor
      in: query
      schema:
        type: string
      description: Pagination cursor from the previous response's `nextCursor`
  schemas:
    Event:
      type: object
      properties:
        eventId:
          type: string
        sessionId:
          type: string
        eventType:
          type: string
          enum:
            - page_view
            - click
            - scroll_depth
            - video_play
            - video_pause
            - video_complete
            - exit_intent
            - form_submission
            - copy
          description: >
            The type of behavioral event. Every event includes the base fields
            (eventId, sessionId, eventType, timestamp, url, pageTitle). Only
            `click` events add `clickElement`/`clickHref`, and only
            `scroll_depth` events add `scrollPercentage`; all other types carry
            the base fields only.
        timestamp:
          type: string
          format: date-time
        url:
          type: string
        pageTitle:
          type: string
          nullable: true
        clickElement:
          type: string
          nullable: true
          description: Only present for click events
        clickHref:
          type: string
          nullable: true
          description: Only present for click events
        scrollPercentage:
          type: integer
          nullable: true
          description: Only present for scroll_depth events
    Pagination:
      type: object
      properties:
        limit:
          type: integer
          description: Requested page size
        count:
          type: integer
          description: Number of items in this page
        nextCursor:
          type: string
          nullable: true
          description: Pass this as `cursor` to get the next page. Null when no more pages.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'API key in format: mk_live_{40 hex chars}'

````