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": "Poseidon"
}
POST /get_data

Request federal data with AI-powered dataset matching and FOIA-compliant two-tier redaction via the Acme Redactors cloaking device.

Authentication: Optional (JWT)

Request Body

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

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
  },
  "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"
  }
}

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