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

# Add to blocklist



## OpenAPI

````yaml openapi/fraud.yaml post /fraud/blocklist
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/blocklist:
    post:
      tags:
        - Blocklist
      summary: Add to blocklist
      operationId: addToBlocklist
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BlocklistEntry'
      responses:
        '201':
          description: Entity added
components:
  schemas:
    BlocklistEntry:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - device
            - ip
            - email
            - phone
            - document
        value:
          type: string
        reason:
          type: string
        expires_at:
          type: string
          format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````