> ## 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.

# GETTOKEN

Generates single-use SHA-256 tokens for the V3 server-to-server flow, which hides sensitive SEARCH/REVIEW scores behind a server-side response.

Call this client-side with your publishable key. Generate 1–10 tokens per call with the `tokens=` parameter (defaults to 1). Each token can be used for **one** transaction and cannot be reused. Pass the returned token in the header of the subsequent SEARCH or REVIEW call, along with your private key.

See [Security Options](https://docs.repdata.com/research-defender/overview/02-security-options) for the full workflow.


## OpenAPI

````yaml GET /api/v3/respondents/get_token/{publishable_key}
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:
  /api/v3/respondents/get_token/{publishable_key}:
    get:
      summary: GETTOKEN
      operationId: Tokens_GetToken
      parameters:
        - name: publishable_key
          in: path
          required: true
          description: Your Research Defender publishable key (client-side).
          schema:
            type: string
          example: 9fc32a73-8165-4dd4-ae19-458bed3c8db5
        - name: tokens
          in: query
          required: false
          description: Number of tokens to generate (1–10). Defaults to 1.
          schema:
            type: integer
          example: 2
        - name: rt_sr_pd
          in: query
          required: false
          description: >-
            Optional panelist ID (only for customers who know respondent
            identity).
          schema:
            type: string
        - name: rt_hd_el
          in: query
          required: false
          description: >-
            Optional hashed email (only for customers who know respondent
            identity).
          schema:
            type: string
      responses:
        '200':
          description: One or more single-use SHA-256 tokens.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tokens:
                    type: array
                    items:
                      type: string
                      description: A single-use SHA-256 token.
              example:
                tokens:
                  - 7d8f...a1
                  - b3c9...e2

````