The Ready Mindset API

{
  "success": true,
  "data": {
    "session_id":      "sess_fd8d5689e10efefa",
    "client_id":       "client_abc123",
    "language":        "en",
    "status":          "created",
    "created_at":      "2026-06-25T05:30:25.274Z",
    "total_questions": 40,
    "questions": [
      {
        "idx": 0,
        "id": "inner_narrative",
        "name": "Inner Narrative",
        "questions": [
          { "id": "inner_narrative_q1", "text": "I tell myself I'm not the kind of person who finishes things." }
          // ... 4 more questions for this barrier
        ]
      }
      // ... 7 more barrier groups, 40 questions total across all 8
    ],
    "questions_url": "https://api.myreadymindset.com/v1/assessment/sessions/sess_fd8d5689e10efefa/questions"
  }
}

{
  "answers": {
    "inner_narrative_q1": 5,
    "inner_narrative_q2": 4,
    // ... all 40 question IDs, each 1-5
    "isolation_trap_q5": 5
  },
  "user": { "name": "Jane Doe", "email": "jane@example.com" },
  "session_id": "sess_fd8d5689e10efefa",
  "client_id": "client_abc123"
}

{
  "success": true,
  "data": {
    "user": { "name": "Jane Doe", "email": "jane@example.com" },
    "assessed_at":           "2026-06-25T05:31:10.000Z",
    "mq_score":              87,
    "mq_level":               "Constrained",
    "mq_level_description":  "Significant barriers across multiple dimensions. Structured, targeted intervention is recommended.",
    "profile_key":           "0,6,7",
    "barrier_scores": [
      { "idx": 0, "id": "inner_narrative", "name": "Inner Narrative", "tool": "The Narrative Reset", "score": 22, "answered": 5 }
      // ... all 8 barriers, always present and in fixed order regardless of score
    ],
    "top_3_barriers": [
      { "idx": 0, "id": "inner_narrative", "name": "Inner Narrative", "score": 22 }
      // ... 2 more — these 3 form the profile_key above
    ],
    "primary_barrier": {
      "idx": 0, "id": "inner_narrative", "name": "Inner Narrative",
      "score": 22, "tool": "The Narrative Reset"
    },
    "barrier_profile": {
      "name":    "The Lonely Overwhelmed Self-Doubter",
      "cluster": "The Lonely Struggler",
      "insight": "Impossible tasks faced alone while the inner voice confirms every fear about your capacity."
    },
    "cost_profile": {
      "name":           "The Impossible Solitude",
      "dimensions":     ["Psychological", "Health", "Identity"],
      "description":    "Impossible tasks faced alone while the inner voice confirms every fear. One of the highest-burnout cost profiles in the matrix.",
      "severity_color": "#C0392B"
    }
  }
}

{ "barrier_indices": [0, 6, 7] }

{
  "client_id":       "client_abc123",
  "external_id":     "user_7890",
  "email":           "sarah@example.com",
  "first_name":      "Sarah",
  "practitioner_id": "prac_xyz",
  "latest_mq_score": 87,
  "assessment_count":2,
  "pathway_day":     34,
  "created_at":      "2026-06-01T09:00:00Z"
}

{
  "client_id": "client_abc123",
  "assessments": [
    {
      "session_id":  "sess_day1",
      "day":          1,
      "mq_score":    112,
      "completed_at":"2026-06-01T09:00:00Z"
    },
    {
      "session_id":  "sess_day30",
      "day":          30,
      "mq_score":    87,
      "completed_at":"2026-07-01T10:22:00Z"
    }
  ],
  "score_delta": -25,
  "trend":       "improving"
}

{
  "client_id":     "client_abc123",
  "current_day":   34,
  "current_phase": "deepening",
  "current_week":  5,
  "overall_pct":   28,
  "streak_days":   7,

  "phases": {
    "foundation":  { "complete": true,  "pct": 100 },
    "deepening":   { "complete": false, "pct": 15  },
    "integration": { "complete": false, "pct": 0   }
  },

  "current_week_tasks": [
    { "id": "w5t1", "task": "Deploy Invasion Forecast", "complete": true,  "category": "tool"     },
    { "id": "w5t2", "task": "Track defence effectiveness", "complete": false, "category": "tool"     },
    { "id": "w5t3", "task": "Four-barrier analysis",       "complete": false, "category": "reflect"  },
    { "id": "w5t4", "task": "Run all 4 tools in protocol",  "complete": false, "category": "protocol" },
    { "id": "w5t5", "task": "Trinity Challenger daily report","complete": false, "category": "trinity"  }
  ]
}

{
  "task_id":  "w5t2",
  "complete": true,
  "journal_entry": "Optional journal text for this task"
}

{
  "practitioners": [
    {
      "practitioner_id": "prac_xyz",
      "name":             "Dr. Sarah Okafor",
      "level":            "RMP",
      "client_count":     12,
      "status":           "active"
    }
  ],
  "total": 1
}

{
  "org_id":           "org_acme",
  "team_size":        47,
  "assessed":         43,
  "avg_mq_score":     94,
  "mq_distribution": {
    "ready":       6,
    "developing": 14,
    "constrained":18,
    "blocked":     5,
    "crisis":      0
  },
  "barrier_heatmap": {
    "inner_narrative":    16.2,
    "unfinished_business":14.8,
    "autopilot_trap":     12.4,
    "scarcity_lens":      11.9,
    "invasion_factor":    10.2,
    "timing_mismatch":    9.7,
    "capacity_gap":       8.3,
    "isolation_trap":     7.1
  }
}

{
  "employees": [
    { "email": "alice@acme.com", "department": "Engineering" },
    { "email": "bob@acme.com",   "department": "Sales"       }
  ],
  "message": "Optional custom message in the invite email"
}