fidro-io API

openapi: 3.1.0
info:
  title: fidro-io API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 9 operation(s) read from 40 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; fidro-io has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 6
    documentation: 3
    pages-with-code: 26
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://fidro.io/docs/api
  - https://fidro.io/docs
  - https://fidro.io/llms-full.txt
  - https://fidro.io/integrations/fastapi
  - https://fidro.io/docs/guides/quickstart
  - https://fidro.io/docs/guides/common-error-codes
  - https://fidro.io/docs/guides/understanding-audit-logs
  - https://fidro.io/docs/guides/quickstart.md
  - https://fidro.io/docs/guides/email-vs-ip-validation
  - https://fidro.io/docs/guides/setting-up-stripe-chargeback-prevention
  - https://fidro.io/docs/guides/card-fingerprint-tracking
  - https://fidro.io/docs/guides/managing-blocklists
  - https://fidro.io/features
  - https://fidro.io/tools
  - https://fidro.io/tools/email-checker
  - https://fidro.io/tools/bulk-email-checker
  - https://fidro.io/tools/ip-checker
  - https://fidro.io/tools/vpn-detector
  - https://fidro.io/tools/domain-checker
  - https://fidro.io/mcp
  - https://fidro.io/docs/guides/common-error-codes.md
  - https://fidro.io/docs/guides/understanding-audit-logs.md
  - https://fidro.io/docs/guides/email-vs-ip-validation.md
  - https://fidro.io/docs/guides/setting-up-stripe-chargeback-prevention.md
  - https://fidro.io/docs/guides/card-fingerprint-tracking.md
  - https://fidro.io/docs/guides/managing-blocklists.md
  - https://fidro.io/disposable-emails
  - https://fidro.io/integrations/nodejs
  - https://fidro.io/integrations/python
  - https://fidro.io/integrations/php
  - https://fidro.io/integrations/go
  - https://fidro.io/integrations/ruby
  - https://fidro.io/integrations/laravel
  - https://fidro.io/integrations/nextjs
  - https://fidro.io/integrations/django
  - https://fidro.io/integrations/express
  - https://fidro.io/disposable-emails/0-mail.com
  - https://fidro.io/disposable-emails/0-mailer.dynv6.net
  - https://fidro.io/disposable-emails/000-webmail.myhome-server.de
  - https://fidro.io/disposable-emails/000000000000000.theworkpc.com
paths:
  /api/blocklist:
    get:
      operationId: get_api_blocklist
      tags:
      - Api
      summary: List all blocklist entries with optional filters.
      x-source: https://fidro.io/docs/api
      parameters:
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: Filter by type (email, ip, domain)
      - name: value
        in: query
        required: false
        schema:
          type: string
        description: Filter by value
      - name: severity
        in: query
        required: false
        schema:
          type: integer
        description: Filter by severity (1-10)
      - name: is_public
        in: query
        required: false
        schema:
          type: boolean
        description: Filter by public status
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBlocklistResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_blocklist
      tags:
      - Api
      summary: Create a new blocklist entry.
      x-source: https://fidro.io/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiBlocklistRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBlocklistResponse'
      x-evidence:
        kind: documentation
  /api/domain-lookup:
    post:
      operationId: post_api_domain_lookup
      tags:
      - Api
      summary: POST /api/domain-lookup
      x-source: https://fidro.io/tools/domain-checker
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDomainLookupRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://fidro.io/api/domain-lookup  -H \"Authorization: Bearer YOUR_API_KEY\"  -d '{\"domain\": \"example.com\"\
          }' \n Start catching bad signups in the next 5 minutes\n Create your account, grab your API key, and send your first request. Free plan\
          \ with 200 validations/month. No credit card. Cancel anytime.\n Start free, 200 lookups/month \n Read the docs \n Fidro \n Developer-first\
          \ fraud detection"
  /api/ip:
    get:
      operationId: get_api_ip
      tags:
      - Api
      summary: GET /api/ip
      x-source: https://fidro.io/integrations/go
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: go
        snippet: http.NewRequest("GET", "https://fidro.io/api/ip/"
  /api/status:
    get:
      operationId: get_api_status
      tags:
      - Api
      summary: Check API status and verify your API key is working.
      x-source: https://fidro.io/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiStatusResponse'
      x-evidence:
        kind: documentation
  /api/validate:
    post:
      operationId: post_api_validate
      tags:
      - Api
      summary: POST /api/validate
      x-source: https://fidro.io/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiValidateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://fidro.io/api/validate  -H \"Authorization: Bearer sk_test_YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\n \"email\": \"user@example.com\"\n }' \n copied = false, 2000)\"\n class=\"absolute top-3 right-3 px-3 py-1.5 bg-white/10\
          \ hover:bg-white/20 text-[#EDEDEC] rounded-full text-xs font-medium transition-all opacity-0 group-hover:opacity-100 flex items-center\
          \ gap-1.5\"\n >\n Copy "
  /api/webhooks/stripe/{accountId}:
    get:
      operationId: get_api_webhooks_stripe_accountId
      tags:
      - Api
      summary: Webhook endpoint for Stripe payment and dispute events to Fidro for chargeback risk analysis.
      x-source: https://fidro.io/docs/guides/setting-up-stripe-chargeback-prevention
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/webhooks/stripe/{account}:
    post:
      operationId: post_api_webhooks_stripe_account
      tags:
      - Api
      summary: Receive real-time notifications about Stripe transaction analysis.
      x-source: https://fidro.io/docs/api
      parameters:
      - name: account
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /mcp:
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: Fidro MCP Server for fraud checks in ChatGPT, Claude & Cursor with 6 tools for validating signups, looking up IPs, and managing
        blocklists.
      x-source: https://fidro.io/mcp
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiBlocklistResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier (UUID)
        type:
          type: string
          description: 'Type of entry: "email", "ip", or "domain"'
        value:
          type: string
          description: The blocked value (email address, IP, or domain)
        reason:
          type: string
          description: Reason for blocking
        severity:
          type: integer
          description: Severity level from 1 (low) to 10 (high)
        is_public:
          type: boolean
          description: Whether this entry is shared publicly
        created_at:
          type: string
          description: ISO 8601 timestamp of when the entry was created
    PostApiBlocklistRequest:
      type: object
      properties:
        type:
          type: string
          description: 'Type of entry: "email", "ip", or "domain"'
        value:
          type: string
          description: The value to block (email address, IP, or domain)
        reason:
          type: string
          description: Reason for blocking this entry
        severity:
          type: integer
          description: 'Severity level from 1 (low) to 10 (high). Default: 5'
        is_public:
          type: boolean
          description: 'Share this entry publicly. Default: false'
      required:
      - type
      - value
    PostApiBlocklistResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier (UUID)
        type:
          type: string
          description: 'Type of entry: "email", "ip", or "domain"'
        value:
          type: string
          description: The blocked value (email address, IP, or domain)
        reason:
          type: string
          description: Reason for blocking
        severity:
          type: integer
          description: Severity level from 1 (low) to 10 (high)
        is_public:
          type: boolean
          description: Whether this entry is shared publicly
        created_at:
          type: string
          description: ISO 8601 timestamp of when the entry was created
    PostApiDomainLookupRequest:
      type: object
      properties:
        domain:
          type: string
    GetApiStatusResponse:
      type: object
      properties:
        message:
          type: string
          description: A friendly status message
        api_key:
          type: string
          description: Type of API key being used ("test" or "live")
        timestamp:
          type: string
          description: ISO 8601 timestamp of when the response was generated
    PostApiValidateRequest:
      type: object
      properties:
        email:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Mcp