API Reference

https://api.mindpeeker.com/v1

Authorization: Bearer your_api_key_here

POST /sessions

{
  "type": "remote_viewing|dowsing|automatic_writing",
  "target": "string",
  "modality": "visual|kinesthetic|auditory",
  "duration_minutes": 30,
  "privacy_level": "public|private|classified"
}

{
  "session_id": "sess_123456789",
  "status": "initiated|in_progress|completed|failed",
  "created_at": "2025-01-15T10:30:00Z",
  "estimated_completion": "2025-01-15T11:00:00Z"
}

GET /sessions/{session_id}

{
  "session_id": "sess_123456789",
  "status": "in_progress",
  "progress": 65,
  "current_phase": "data_collection",
  "results_available": false,
  "estimated_completion": "2025-01-15T10:45:00Z"
}

GET /sessions/{session_id}/results

{
  "session_id": "sess_123456789",
  "status": "completed",
  "results": {
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060,
      "confidence": 0.87
    },
    "descriptors": [
      "urban environment",
      "water body nearby",
      "historical building"
    ],
    "sketches": [
      {
        "url": "https://cdn.mindpeeker.com/sketches/sess_123456789_1.png",
        "description": "Target location overview"
      }
    ],
    "confidence_score": 0.87,
    "validation_metrics": {
      "accuracy": 0.82,
      "reliability": 0.91
    }
  },
  "metadata": {
    "duration_minutes": 28,
    "modality": "visual",
    "analyst_id": "analyst_456"
  }
}

POST /analysis/targets

{
  "target_type": "location|person|object|event",
  "reference_material": {
    "photos": ["url1", "url2"],
    "documents": ["url1"],
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    }
  },
  "analysis_type": "comprehensive|quick_scan|deep_dive",
  "priority": "low|medium|high|urgent"
}

{
  "analysis_id": "anal_123456789",
  "status": "queued",
  "estimated_completion": "2025-01-15T11:30:00Z",
  "priority": "high"
}

GET /analysis/{analysis_id}/results

{
  "analysis_id": "anal_123456789",
  "status": "completed",
  "results": {
    "summary": "Analysis of target location reveals...",
    "key_findings": [
      "Structural anomalies detected",
      "Temporal inconsistencies present",
      "High psychic resonance signature"
    ],
    "confidence_score": 0.91,
    "risk_assessment": {
      "level": "medium",
      "factors": ["temporal_instability", "energy fluctuations"]
    },
    "recommendations": [
      "Further investigation recommended",
      "Monitor for temporal anomalies"
    ]
  },
  "processing_time": "45 minutes"
}

POST /dowsing/query

{
  "query_type": "location|information|yes_no",
  "question": "string",
  "context": {
    "location": {
      "latitude": 40.7128,
      "longitude": -74.0060,
      "radius_meters": 1000
    },
    "timeframe": "past|present|future",
    "parameters": {}
  },
  "precision_level": "standard|high|maximum"
}

{
  "query_id": "dowse_123456789",
  "status": "completed",
  "result": {
    "answer": "positive|negative|neutral|specific_value",
    "confidence": 0.89,
    "coordinates": {
      "latitude": 40.7132,
      "longitude": -74.0058,
      "accuracy_meters": 15
    },
    "additional_insights": [
      "Strong energy signature detected",
      "Historical significance present"
    ],
    "chart_data": {
      "chart_type": "radar|pendulum|divining_rod",
      "readings": [0.8, 0.6, 0.9, 0.7],
      "interpretation": "Strong positive response"
    }
  }
}

GET /history/search

{
  "results": [
    {
      "id": "hist_123456789",
      "type": "remote_viewing",
      "date": "2024-03-15T14:30:00Z",
      "target": "Missing person case - John Doe",
      "outcome": "successful",
      "confidence_score": 0.92,
      "location": {
        "latitude": 40.7128,
        "longitude": -74.0060
      }
    }
  ],
  "total": 156,
  "limit": 20,
  "offset": 0,
  "has_more": true
}

GET /history/{case_id}

{
  "case_id": "hist_123456789",
  "type": "remote_viewing",
  "date": "2024-03-15T14:30:00Z",
  "target": "Missing person case - John Doe",
  "client": "FBI Field Office New York",
  "analysts": ["analyst_456", "analyst_789"],
  "process": {
    "duration_minutes": 45,
    "modality": "visual",
    "phases": ["targeting", "exploration", "documentation"]
  },
  "results": {
    "location_found": true,
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.0060
    },
    "description": "Abandoned warehouse basement",
    "verification": "confirmed by law enforcement"
  },
  "outcome": "successful_rescue",
  "confidence_score": 0.92,
  "validation": {
    "independent_verification": true,
    "accuracy_confirmed": true
  }
}

interface Session {
  session_id: string;
  type: 'remote_viewing' | 'dowsing' | 'automatic_writing';
  status: 'initiated' | 'in_progress' | 'completed' | 'failed';
  target: string;
  modality: 'visual' | 'kinesthetic' | 'auditory';
  duration_minutes: number;
  privacy_level: 'public' | 'private' | 'classified';
  created_at: string;
  estimated_completion?: string;
  progress?: number;
  current_phase?: string;
  results?: SessionResults;
}

interface Analysis {
  analysis_id: string;
  target_type: 'location' | 'person' | 'object' | 'event';
  status: 'queued' | 'processing' | 'completed' | 'failed';
  results?: AnalysisResults;
  confidence_score: number;
  processing_time?: string;
  created_at: string;
  completed_at?: string;
}

interface DowsingResult {
  query_id: string;
  query_type: 'location' | 'information' | 'yes_no';
  answer: 'positive' | 'negative' | 'neutral' | string;
  confidence: number;
  coordinates?: {
    latitude: number;
    longitude: number;
    accuracy_meters: number;
  };
  additional_insights: string[];
  chart_data: {
    chart_type: 'radar' | 'pendulum' | 'divining_rod';
    readings: number[];
    interpretation: string;
  };
}

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request parameters",
    "details": {
      "field": "target",
      "issue": "Target cannot be empty"
    },
    "request_id": "req_123456789"
  }
}

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1642248000

POST /webhooks

{
  "url": "https://your-app.com/webhook",
  "events": ["session.completed", "analysis.completed"],
  "secret": "your_webhook_secret"
}

{
  "event": "session.completed",
  "data": {
    "session_id": "sess_123456789",
    "status": "completed",
    "completed_at": "2025-01-15T11:00:00Z"
  },
  "timestamp": "2025-01-15T11:00:01Z"
}

https://sandbox-api.mindpeeker.com/v1