Skip to main content
Developer API

Build on Grove

The developmental intelligence API for education, talent, and human potential. Integrate cognitive insights into any platform.

Request API AccessView Endpoints →
Terminal
curl -X POST https://exploregrove.com/api/v1/assess \
  -H "Authorization: Bearer grove_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"childId":"abc","interaction":"..."}'
Use Cases

What you can build

Adaptive Learning Platforms

Build learning experiences that know each student's cognitive state. Serve the right challenge at the right time based on real developmental data.

Assessment Tools

Move beyond standardized tests. Measure development, not just knowledge. Understand how students think, not just what they answer.

Talent Platforms

Access verified cognitive profiles for hiring and talent development. See thinking style, learning velocity, and collaboration patterns.

Research Tools

Access anonymized developmental data for educational research. Track cognitive development patterns across populations.

API Reference

Core API Endpoints

Every endpoint returns clean JSON. Authentication via Bearer token. Consistent error format across all endpoints.

POST/api/v1/assessscope: assess

Run Assessment

Analyze a child's interaction and return developmental dimensions, skill levels, and suggestions.

Request

{
  "childId": "child_abc123",
  "interaction": "I think fractions are like pizza slices...",
  "context": "math problem about fractions"
}

Response

{
  "dimensions": {
    "reasoning_quality": 72,
    "cognitive_depth": 65,
    "curiosity_drive": 88
  },
  "skills": [{
    "name": "fractions",
    "level": "zpd",
    "bloom": "apply"
  }],
  "suggestions": [
    "Try a multi-step problem next..."
  ]
}
GET/api/v1/queryscope: query

Query Knowledge Graph

Retrieve nodes, connections, and stats from a child's cognitive knowledge graph.

Request

GET /api/v1/query?childId=child_abc123&domain=math

Response

{
  "nodes": [{
    "name": "Fractions",
    "type": "Skill",
    "mastery": "zpd",
    "strength": 0.7
  }],
  "connections": [{
    "from": "Fractions",
    "to": "Division",
    "type": "PREREQUISITE"
  }],
  "stats": { "totalNodes": 47, "domains": 5 }
}
GET/api/v1/predictscope: predict

Developmental Predictions

Get AI-powered predictions about upcoming milestones, breakthroughs, and areas of attention.

Request

GET /api/v1/predict?childId=child_abc123

Response

{
  "trajectory": "upward",
  "predictions": [{
    "type": "milestone",
    "title": "Ready for abstract fraction operations",
    "confidence": 0.85,
    "timeframe": "2-3 weeks"
  }]
}
GET/api/v1/profilescope: profile

Grove Profile

Get a comprehensive developmental profile including verified dimensions, thinking style, and employer insights.

Request

GET /api/v1/profile?childId=child_abc123

Response

{
  "dimensions": {
    "reasoning_quality": { "score": 72, "trend": "rising" },
    "curiosity_drive": { "score": 88, "trend": "stable" }
  },
  "thinkingStyle": {
    "primary": "divergent-analytical",
    "strengths": ["pattern recognition", ...]
  },
  "employerInsights": {
    "cognitiveProfile": "High-potential divergent thinker..."
  }
}
POST/api/v1/enrichscope: write

Enrich Knowledge Graph

Write interaction data back to the child's knowledge graph. Requires the "write" scope.

Request

{
  "childId": "child_abc123",
  "interactions": [{
    "type": "completed_lesson",
    "topic": "cell biology",
    "score": 0.85
  }]
}

Response

{
  "interactionsProcessed": 1,
  "nodesUpdated": 3,
  "connectionsCreated": 2
}
Partner Read API

Third-party read access

Read-only endpoints for schools, therapists, and pediatricians. Each request requires a valid API key and explicit parent consent for the specific child.

GET/api/v1/children/{childId}/dimensionsscope: dimensionsconsent required

Dimension Scores

Returns current scores across 12 developmental dimensions organized in 3 tiers: Foundation, Cognitive, and Mastery. Requires parent consent with the "dimensions" scope.

Request

GET /api/v1/children/child_abc123/dimensions
Authorization: Bearer grove_sk_...

Response

{
  "data": {
    "childId": "child_abc123",
    "snapshotDate": "2026-03-25T12:00:00Z",
    "tiers": {
      "foundation": {
        "curiosity": 0.82,
        "emotionalRegulation": 0.71,
        "selfDirection": 0.65,
        "socialAwareness": 0.74
      },
      "cognitive": {
        "cognitiveDepth": 0.78,
        "reasoningQuality": 0.69
      },
      "mastery": {
        "metacognition": 0.55,
        "systemsThinking": 0.48
      }
    }
  }
}
GET/api/v1/children/{childId}/blueprintscope: blueprintconsent required

Blueprint Summary

Returns the latest Blueprint including executive summary, dimension highlights with trends, top interests, and recommended focus areas. Requires parent consent with the "blueprint" scope.

Request

GET /api/v1/children/child_abc123/blueprint
Authorization: Bearer grove_sk_...

Response

{
  "data": {
    "childId": "child_abc123",
    "quarter": "Q1-2026",
    "executiveSummary": "Shows strong curiosity-driven learning...",
    "dimensionHighlights": [
      { "dimension": "curiosity", "score": 0.82, "trend": "rising" }
    ],
    "topInterests": ["marine biology", "creative writing"],
    "recommendedFocusAreas": ["metacognitive reflection"]
  }
}
GET/api/v1/children/{childId}/sessions/summaryscope: sessionsconsent required

Session Summaries

Returns session summaries for the last 30 days including topic, duration, dimensions touched, and learning track. Requires parent consent with the "sessions" scope.

Request

GET /api/v1/children/child_abc123/sessions/summary
Authorization: Bearer grove_sk_...

Response

{
  "data": {
    "childId": "child_abc123",
    "totalSessions": 18,
    "totalMinutes": 342,
    "sessions": [{
      "topic": "Ocean ecosystems and food chains",
      "durationMinutes": 22,
      "dimensionsTouched": ["curiosity", "knowledgeBreadth"],
      "track": "explorer"
    }]
  }
}
GET/api/v1/children/{childId}/graph/overviewscope: graphconsent required

Knowledge Graph Overview

Returns knowledge graph statistics: node/edge counts, cluster count, top interests with strength scores, and cluster breakdowns. Requires parent consent with the "graph" scope.

Request

GET /api/v1/children/child_abc123/graph/overview
Authorization: Bearer grove_sk_...

Response

{
  "data": {
    "childId": "child_abc123",
    "stats": {
      "totalNodes": 247,
      "totalEdges": 583,
      "clusterCount": 8
    },
    "topInterests": [
      { "topic": "Marine Biology", "nodeCount": 42, "strength": 0.92 }
    ],
    "clusters": [
      { "name": "Ocean Science", "nodeCount": 42, "domains": ["biology", "ecology"] }
    ]
  }
}
Privacy First

Data sharing & consent

Parents maintain full control over what data is shared and with whom. Every API request is validated against explicit consent records.

Per-child consent

Parents grant access to each child individually from their Grove dashboard. Access to one child does not imply access to siblings.

Per-partner consent

Each school, therapist, or pediatrician is a registered partner. Consent is granted to a specific partner, not to all API users.

Scoped access

Parents choose which data to share: dimensions, blueprints, session summaries, and/or knowledge graph data. Each scope can be granted or revoked independently.

Revocable at any time

Parents can revoke consent instantly from the Grove dashboard. Once revoked, subsequent API requests for that child return 403 Forbidden.

COPPA & FERPA Compliant

Grove never shares raw conversation transcripts through the API. Only aggregated developmental insights, dimension scores, and summary data are available. All data is scoped per-child and per-partner with explicit parent authorization.

Error Responses

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENNo consent granted for this child/scope, or missing required scope
404NOT_FOUNDChild not found
429RATE_LIMITEDToo many requests — check the Retry-After header
Pricing

Start free, scale as you grow

Free

$0/month

1,000 calls/month

  • All 5 endpoints
  • Standard rate limits
  • Community support
Get Started

Growth

$99/month

10,000 calls/month

  • All 5 endpoints
  • Higher rate limits
  • Email support
  • Usage analytics
Request Access

Scale

$499/month

100,000 calls/month

  • All 5 endpoints
  • Priority rate limits
  • Dedicated support
  • SLA guarantee
  • Webhooks
Request Access

Enterprise

Custom

Unlimited

  • Custom endpoints
  • Dedicated infrastructure
  • White-glove onboarding
  • Custom SLA
  • On-premise option
Contact Us

Trusted Foundation

Built on 150+ years of developmental science

Grove's developmental model draws from Piaget, Vygotsky, Gardner, Bloom, and modern cognitive science. Every API response is grounded in validated developmental frameworks.

COPPA Compliant
SOC 2 (In Progress)
Data Encrypted
Parent Controlled
Request API Access