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

# List Report Share Visits

> Visits to the report's share link over the last `days` days, newest first, 20 at a time: when, device, country, time spent, pages opened and other actions. For the next page send `next.before_at` and `next.before_id` back. Visitors signed in to Oviond are not counted.



## OpenAPI

````yaml https://api.oviond.com/openapi.json get /v1/reports/{id}/analytics/visits
openapi: 3.1.0
info:
  title: Oviond Backend API
  version: 1.0.0
  description: Authentication, account management, billing, and media services for Oviond.
  x-logo:
    url: https://app.oviond.com/img/oviond-full-logo.svg
    altText: Oviond
servers:
  - url: https://api.oviond.com
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /v1/reports/{id}/analytics/visits:
    get:
      tags:
        - Reports
      summary: List Report Share Visits
      description: >-
        Visits to the report's share link over the last `days` days, newest
        first, 20 at a time: when, device, country, time spent, pages opened and
        other actions. For the next page send `next.before_at` and
        `next.before_id` back. Visitors signed in to Oviond are not counted.
      operationId: list_report_share_visits
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
        - schema:
            type: string
            enum:
              - '7'
              - '30'
              - '90'
              - '365'
            default: '30'
            description: How many days back to count.
            example: '30'
          required: false
          name: days
          in: query
        - schema:
            type: string
            format: date-time
            description: 'The next page: `next.before_at` from the page before.'
          required: false
          name: before_at
          in: query
        - schema:
            type: string
            format: uuid
            description: >-
              The next page: `next.before_id` from the page before. Sent with
              `before_at`.
          required: false
          name: before_id
          in: query
      responses:
        '200':
          description: One page of visits
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/ReportVisits'
                required:
                  - success
                  - data
        '400':
          description: before_at sent without before_id, or the other way round
        '404':
          description: Report not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  schemas:
    ReportVisits:
      type: object
      properties:
        visits:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              started_at:
                type: string
              device:
                type: string
                enum:
                  - desktop
                  - mobile
                  - tablet
                  - other
              country:
                type:
                  - string
                  - 'null'
              seconds:
                type: number
              pages:
                type: number
              actions:
                type: number
              wrong_passwords:
                type: number
              locked:
                type: boolean
            required:
              - id
              - started_at
              - device
              - country
              - seconds
              - pages
              - actions
              - wrong_passwords
              - locked
        next:
          type:
            - object
            - 'null'
          properties:
            before_at:
              type: string
            before_id:
              type: string
          required:
            - before_at
            - before_id
      required:
        - visits
        - next
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Oviond API key (prefix `oviond_`) sent as a Bearer token — the
        credential for REST/programmatic and headless integrations. Manage keys
        in Settings → API Keys. API keys do NOT authenticate the MCP endpoint
        (/mcp), which uses OAuth 2.1 + PKCE.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase-issued JWT used by the Oviond web app session. External API
        consumers should authenticate with an Oviond API key (ApiKeyAuth)
        instead.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.