System Diagnostics

Authentication

/get_data is publicly accessible — no token required for open use. Optionally include a JWT token to associate requests with your account:

Authorization: Bearer YOUR_JWT_TOKEN
POST /signup

Create a new operator account and receive a JWT token.

Request Body

{
  "email": "operator@example.com",
  "password": "secure_password"
}

Response (201)

{
  "message": "User created successfully",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
POST /login

Authenticate an existing operator and receive a JWT token.

Request Body

{
  "email": "operator@example.com",
  "password": "secure_password"
}

Response (200)

{
  "message": "Login successful",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Core Endpoints

GET /ping

Health check. No authentication required.

Response (200)

{
  "status": "ok",
  "timestamp": "2026-01-27T12:00:00.000000",
  "service": "Acme Redactors"
}
POST /get_data

Request public records with AI-powered dataset matching and FOIA-compliant redaction via the Acme Redactors cloaking device. Privacy is configurable per query — see Pricing.

Authentication: Optional (JWT)

Request Body

{
  "description": "CIA contractor employment records with clearance levels",
  "privacy_level": "standard"
}

privacy_level is optional, one of reduced | standard (default) | aggressive. See Pricing for what each tier does and costs.

Response (200)

{
  "status": "success",
  "original_data": [
    {
      "id": "cia-contractor-employment",
      "category": "intelligence",
      "data": {
        "classification": "TOP SECRET // HCS // NOFORN",
        "records": [
          {
            "employee_id": "CIA-HC-2019-04371",
            "ssn": "412-67-8234",
            "name": "Marcus J. Thompson",
            "date_of_birth": "1984-06-12",
            "position_title": "Signals Intelligence Analyst",
            "clearance_level": "TS/SCI",
            "assignment_location": "Camp Peary (The Farm), Williamsburg, VA",
            "pay_grade": "GS-14",
            "annual_salary": 122530,
            "supervising_officer": "Deputy Director Karen M. Ortiz"
          }
        ]
      }
    }
  ],
  "data": [
    {
      "id": "cia-contractor-employment",
      "category": "intelligence",
      "data": {
        "classification": "[b(Ex.1)]",
        "records": [
          {
            "employee_id": "CIA-HC-2019-04371",
            "ssn": "[b(Ex.3)]",
            "name": "David R. Ellison",
            "date_of_birth": "1981-09-23",
            "position_title": "Signals Intelligence Analyst",
            "clearance_level": "[b(Ex.1)]",
            "assignment_location": "[b(Ex.1)]",
            "pay_grade": "GS-14",
            "annual_salary": 122530,
            "supervising_officer": "Deputy Director Patricia L. Monroe"
          }
        ]
      }
    }
  ],
  "metadata": {
    "processing_time_seconds": 4.82,
    "records_returned": 1,
    "privacy_applied": true,
    "cached": false
  },
  "pricing": {
    "privacy_level": "standard",
    "tier_label": "Standard Privacy",
    "base_price_usd": 0.25,
    "privacy_addon_usd": 0.00,
    "total_price_usd": 0.25,
    "description": "Two-tier FOIA redaction: statutory blind exemptions plus smart cloaking of personal privacy fields...",
    "billing_note": "Pricing shown for demonstration only; no payment is collected."
  },
  "foia_compliance": {
    "statute": "5 U.S.C. § 552 (Freedom of Information Act)",
    "blind_redactions": "[b(Ex.N)] markers — Ex.1 classified info, Ex.3 SSNs/program IDs",
    "smart_redactions": "Acme Redactors cloaking device — Ex.6 names/addresses/DOB/phone, Ex.7(C) third-party names",
    "segregability": "Non-exempt fields preserved per § 552(b): case IDs, event dates, titles, pay grades, dispositions",
    "presumption": "Openness — withheld only where disclosure would harm a protected interest"
  }
}
POST /redact

Redact an arbitrary pasted record (JSON or plain text) at a chosen privacy tier, without going through dataset matching.

Authentication: None required

Request Body

{
  "record": "Jane Doe, SSN 412-67-8234, lives at 12 Main St...",
  "privacy_level": "aggressive"
}

privacy_level is optional, one of reduced | standard | aggressive (default). record may be a JSON object/array, a JSON-encoded string, or plain text.

Response (200)

{
  "status": "success",
  "original_data": "...",
  "data": "...",
  "is_text": true,
  "metadata": { "processing_time_seconds": 3.11, "privacy_applied": true, "cached": false },
  "pricing": { "privacy_level": "aggressive", "tier_label": "Enhanced Privacy", "total_price_usd": 1.75, "..." : "..." },
  "foia_compliance": { "...": "..." }
}

Pricing — Privacy, Per Query

Standard redaction is included with every query. Two paid add-ons let you move the privacy dial in either direction, per query, via the privacy_level field on /get_data and /redact. Statutory FOIA exemptions (SSNs, classification markings, biometric identifiers, etc.) are withheld at every tier — they are never for sale.

privacy_level Effect Add-on Price
reduced Subtracts discretionary privacy. Only statutory Tier 1 exemptions withheld; personal identifiers (names, addresses, phone, email, DOB) are released in full. +$4.00
standard (default for /get_data) Statutory Tier 1 exemptions plus Tier 2 smart cloaking of personal privacy fields with realistic substitutes. Included
aggressive (default for /redact) Adds privacy. Standard redaction plus aggressive cloaking of indirect identifiers — locations, dates, employers, relationships, physical descriptions. +$1.50

Base query price: $0.25. Pricing shown for demonstration purposes only — this API does not collect payment.

FOIA Compliance & Redaction

All data returned through /get_data is processed under the Freedom of Information Act (5 U.S.C. § 552) using a two-tier redaction scheme implemented by the Acme Redactors cloaking device. The response includes both the original unredacted record and the FOIA-compliant release.

Tier 1 — Blind Redaction [b(Ex.N)]

Classified, statutorily protected, or operationally sensitive information is suppressed entirely and replaced with a [b(Ex.N)] marker citing the applicable FOIA exemption.

Exemption Field Types Example
Ex.1 Classification markings, security clearance levels, covert facility names and addresses "TOP SECRET // HCS // NOFORN""[b(Ex.1)]"
"TS/SCI""[b(Ex.1)]"
Ex.3 Social Security Numbers (CIA Act of 1949), intelligence program identifiers, biometric identifiers "412-67-8234""[b(Ex.3)]"
Ex.7(F) Information that could endanger life or physical safety Source identities, field operative locations

Tier 2 — Cloaked Identities (Acme Redactors)

The Acme Redactors cloaking device camouflages and protects the identities of public servants and US citizens by replacing personal privacy data with different but realistic cover values. Record structure is fully preserved for legitimate oversight.

Exemption Field Types Example
Ex.6 Individual names (contractors, employees, civilians), supervising officer names, dates of birth, personal addresses, phone numbers, email addresses "Marcus J. Thompson""David R. Ellison"
"1984-06-12""1981-09-23"
Ex.7(C) Names of third parties in law enforcement or incident records Bite victim, complainant names → realistic cover identities

Segregability — Fields Preserved

Per 5 U.S.C. § 552(b), all reasonably segregable non-exempt portions are released in full:

Field Category Examples
Administrative identifiers Employee IDs, contract numbers, case numbers
Dates of events Contract start/end, incident dates
Position and grade Position titles, pay grades (GS-14, SES), annual salaries
Outcome/disposition Complaint categories, disposition summaries, citation codes
Non-sensitive location context General city/state, publicly known facility names

Error Codes

CodeDescription
200Success
201Created (signup)
400Bad Request — Missing or invalid parameters
401Unauthorized — Invalid or missing token
409Conflict — Email already registered
500Internal Server Error

Technical Details

PropertyValue
ProtocolHTTP / HTTPS
URLhttps://themithrilcompany.com
InfrastructureDigital Ocean VM + Spaces (S3-compatible)
AI ModelOpenRouter — Llama 3.2 3B with Claude 3.5 Haiku fallback
AuthenticationJWT (30-day expiration)
Redaction EngineAcme Redactors cloaking device