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

# Validate a verification token

> Validates a signed JWT verification receipt. This is the primary server-side check. Optionally include signal_token for combined confidence scoring with Signal Pixel + Turnstile + passkey results.



## OpenAPI

````yaml /openapi-sdk-a.json post /sdk/verify-token
openapi: 3.1.0
info:
  title: BotShield SDK A API
  version: 2.0.0
  description: >-
    BotShield SDK A -- Signal-only human presence verification. Momentary
    presence check with no persistence.
  contact:
    name: BotShield Support
    email: support@botshield.ai
    url: https://botshield.ai
servers:
  - url: https://api.botshield.ai/operations
    description: BotShield API
security: []
tags:
  - name: SDK
    description: >-
      Core SDK operations — session management, verification, token validation,
      and Signal Pixel scoring
  - name: Signal Pixel
    description: >-
      BotShield Signal Pixel — passive behavioral fingerprinting with
      tamper-proof server-side scoring
  - name: Verification
    description: Verification status checking and user lookup
paths:
  /sdk/verify-token:
    post:
      tags:
        - SDK
      summary: Validate a verification token
      description: >-
        Validates a signed JWT verification receipt. This is the primary
        server-side check. Optionally include signal_token for combined
        confidence scoring with Signal Pixel + Turnstile + passkey results.
      operationId: SdkVerifyToken
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - token
              properties:
                token:
                  type: string
                  description: JWT verification receipt
                signal_token:
                  type: string
                  description: Optional Signal Pixel token for combined confidence
      responses:
        '200':
          description: Validation result
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                  reason:
                    type: string
                  confidence:
                    type: number
                    minimum: 0
                    maximum: 1
                    description: Combined confidence (passkey + signals + integrations)
                  claims:
                    type: object
                    properties:
                      request_id:
                        type: string
                      verified:
                        type: boolean
                      organization_id:
                        type: string
                      timestamp:
                        type: string
                      issued_at:
                        type: number
                      expires_at:
                        type: number
                  signals:
                    type: object
                    properties:
                      botshield_score:
                        type: integer
                        description: Signal Pixel score (0-100)
                      turnstile:
                        type: object
                        properties:
                          success:
                            type: boolean
                      passkey:
                        type: object
                        properties:
                          verified:
                            type: boolean

````