Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blindfold.dev/llms.txt

Use this file to discover all available pages before exploring further.

Blindfold operates PII processing nodes in multiple regions. You can select a region to ensure data residency compliance and minimize latency.

​
Available Regions

RegionEndpointLocation
EU (default)https://eu-api.blindfold.devEurope
UShttps://us-api.blindfold.devUnited States
Global (default)https://api.blindfold.devRoutes to EU
If no region is specified, requests are routed to the EU region by default.

​
Selecting a Region

​
Python SDK

from blindfold import Blindfold

# EU region (explicit)
client = Blindfold(api_key="your-key", region="eu")

# US region
client = Blindfold(api_key="your-key", region="us")

​
JavaScript / TypeScript SDK

import { Blindfold } from '@blindfold/sdk';

// EU region (explicit)
const client = new Blindfold({ apiKey: 'your-key', region: 'eu' });

// US region
const client = new Blindfold({ apiKey: 'your-key', region: 'us' });

​
CLI

# EU region
blindfold --region eu tokenize "Contact John Doe at john@example.com"

# US region
blindfold --region us tokenize "Contact John Doe at john@example.com"

# Or set via environment variable
export BLINDFOLD_REGION=us
blindfold tokenize "Contact John Doe at john@example.com"

​
MCP Server

Set the BLINDFOLD_REGION environment variable: 
{
  "mcpServers": {
    "blindfold": {
      "command": "npx",
      "args": ["-y", "@blindfold/mcp-server"],
      "env": {
        "BLINDFOLD_API_KEY": "your-key",
        "BLINDFOLD_REGION": "us"
      }
    }
  }
}

​
Direct API Calls (cURL)

# EU region
curl -X POST https://eu-api.blindfold.dev/api/public/v1/tokenize \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Contact John Doe at john@example.com"}'

# US region
curl -X POST https://us-api.blindfold.dev/api/public/v1/tokenize \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Contact John Doe at john@example.com"}'

​
Data Residency

When you select a region, your text data is processed entirely within that region:
  • EU region: PII detection and processing occurs on EU-based servers.
  • US region: PII detection and processing occurs on US-based servers.
Your API key works across all regions. You do not need separate API keys per region.

​
Priority Order

The region is resolved in this order (highest priority first):
  1. Explicit base URL (base_url / baseUrl / --base-url) - always takes precedence
  2. Region parameter (region / --region / BLINDFOLD_REGION)
  3. Default - routes to EU via api.blindfold.dev

​
Default Behavior

ConfigurationResult
No region, no base URLRoutes to api.blindfold.dev (EU)
region="eu"Routes to eu-api.blindfold.dev
region="us"Routes to us-api.blindfold.dev
base_url="https://custom.dev" + region="us"Routes to https://custom.dev (base URL wins)