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

# Report fraud signal



## OpenAPI

````yaml openapi/fraud.yaml post /fraud/signals
openapi: 3.0.3
info:
  title: TXCloud FraudShield API
  version: 1.0.0
  description: |
    The TXCloud FraudShield API provides fraud detection signals that enhance 
    identity verification, plus tools to manage fraud rules, blocklists, and 
    investigate suspicious activity.

    ## How It Works
    FraudShield is called internally by the Identity API during verification.
    Clients receive fraud signals in the verification response. These endpoints
    are for configuration, investigation, and advanced use cases.
  contact:
    name: TXCloud API Support
    email: support@txcloud.io
servers:
  - url: https://api.txcloud.io/v1
    description: Production
  - url: https://sandbox.api.txcloud.io/v1
    description: Sandbox
security:
  - BearerAuth: []
tags:
  - name: Duplicates
    description: Duplicate detection across verifications
  - name: Devices
    description: Device intelligence and fingerprinting
  - name: Velocity
    description: Rate limiting and velocity controls
  - name: Blocklist
    description: Blocklist management
  - name: Rules
    description: Custom fraud rules engine
  - name: Signals
    description: Fraud signal reporting and management
  - name: Analytics
    description: Fraud analytics and reporting
paths:
  /fraud/signals:
    post:
      tags:
        - Signals
      summary: Report fraud signal
      operationId: reportSignal
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignalReport'
      responses:
        '201':
          description: Signal reported
components:
  schemas:
    SignalReport:
      type: object
      required:
        - type
        - severity
        - description
      properties:
        verification_id:
          type: string
        user_id:
          type: string
        type:
          type: string
        severity:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        description:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````