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

# ACTIVITY (GET)

Cross-platform respondent activity statistics for a token, drawn from the Research Defender ecosystem. Use it to identify professional survey takers through participation counts, averages, medians, and client overlap.

`range` is the analysis window in hours: `1`, `3`, `8`, `12`, `24`, or `168`. Authenticate with the `x-api-key` header. Server-to-server integration with a [GETTOKEN](/research-defender/endpoints/get-token) token is recommended.

See [ACTIVITY](/research-defender/guides/activity/01-overview) for how to read the response.


## OpenAPI

````yaml GET /activity
openapi: 3.0.3
info:
  title: Research Defender API
  version: 1.0.0
  description: >-
    Research Defender protects survey data quality through digital
    fingerprinting, duplication detection, and open-end text analysis. This
    reference covers the **SEARCH**, **REVIEW**, and **PREDUPE** products.


    > ACTIVITY and VERIFY are hosted on a separate domain (resdefio.com) and are
    documented separately.


    ## Authentication


    Client-side calls (SEARCH, REVIEW, GETTOKEN) use your **publishable key** in
    the URL path. Server-side lookups (destination_platforms) use your **private
    key**. For enhanced protection, use V3 server-to-server tokens (GETTOKEN) or
    V4 Hashed Validation.


    ## Environments


    Production: `https://prod.rtymgt.com`  

    Staging: `https://staging.rtymgt.com`
servers:
  - url: https://prod.rtymgt.com
    description: Production
  - url: https://staging.rtymgt.com
    description: Staging
security: []
paths:
  /activity:
    servers:
      - url: https://prod.resdefio.com
        description: Production
      - url: https://stage.resdefio.com
        description: Stage
    get:
      summary: ACTIVITY (GET)
      operationId: Activity_Get
      parameters:
        - name: session_id
          in: query
          required: false
          description: Session identifier (`sn_ud`).
          schema:
            type: string
        - name: survey_number
          in: query
          required: false
          description: Survey identifier (`sy_nr`).
          schema:
            type: string
        - name: range
          in: query
          required: false
          description: Time window in hours.
          schema:
            type: integer
            enum:
              - 1
              - 3
              - 8
              - 12
              - 24
              - 168
        - name: supplier_id
          in: query
          required: false
          description: Supplier identifier.
          schema:
            type: string
      responses:
        '200':
          description: Activity statistics for the token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Statistics:
                    type: array
                    items:
                      type: object
                      properties:
                        Activity:
                          type: object
                          properties:
                            Token:
                              type: object
                              properties:
                                Count:
                                  type: integer
                                  description: >-
                                    Surveys attempted by the token in the
                                    Research Defender ecosystem during the
                                    range.
                                Average:
                                  type: number
                                  description: >-
                                    Average occurrences of sessions per token
                                    during the range.
                                Ratio:
                                  type: number
                                  description: >-
                                    Ratio of devices linked to the respondent's
                                    digital fingerprint or IP address during the
                                    range.
                                Median:
                                  type: number
                                  description: >-
                                    Median of all sessions per token during the
                                    range.
                                StandardDeviation:
                                  type: number
                                  description: >-
                                    Standard deviation of fingerprints found
                                    across the industry within the range.
                                ClientOverlap:
                                  type: integer
                                  description: >-
                                    Unique clients associated with the
                                    respondent during the range.
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key issued for the resdefio.com APIs.

````

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