Nature API
The Nature API exposes the MNTEST assessment and Multiple Natures (MN) scoring engine. Given a set of item responses, it produces a scored profile across 9 Natures and 10 Multiple Intelligences.
What it produces
A profile contains two score sets:
9 Natures (scored 0.0–1.0): Protective, Educative, Administrative, Creative, Healing, Entertaining, Providing, Entrepreneurial, Adventurous
10 Multiple Intelligences (scored 0.0–1.0): Gross Bodily, Fine Bodily, Interpersonal, Logical, Linguistic, Graphic Visual, Spatial Visual, Musical, Intrapersonal, Naturalistic
Scores represent expression strength within the individual's own range — not population percentiles.
The assessment flow
1. Create subject → 2. Start assessment → 3. Submit responses → 4. Retrieve profile
POST /subjects POST /assessments PATCH /assessments GET /profile
All four steps are required to produce a profile. Steps 3 can happen incrementally — you can submit item responses in batches across multiple PATCH calls until the full set (76 items) is complete.
Key concepts
Consent
Consent is captured at subject creation (step 1). The consent_artifact records which version of the consent text was shown, when the person agreed, and a hash of the consent UI displayed. This artifact is retained for the subject lifetime + 7 years.
You are responsible for presenting consent UI to the person. The API stores your artifact; it does not handle consent collection. See Consent.
The MNTEST item bank
The MNTEST item bank (76 items) is a proprietary assessment instrument. The item bank is never returned via the API — the API accepts item responses and returns scored profiles only. This protects the item integrity per LEGAL-GUARDRAILS.
Incremental responses
Item responses can be submitted incrementally. A person can complete the assessment across multiple sessions by submitting partial response sets. The assessment transitions created → in_progress → scoring → completed as responses accumulate.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /v1/nature/subjects | Create a subject with consent artifact |
GET | /v1/nature/subjects | List subjects (cursor paginated) |
GET | /v1/nature/subjects/{id} | Retrieve a subject |
DELETE | /v1/nature/subjects/{id} | Delete a subject (right to erasure) |
POST | /v1/nature/subjects/{id}/assessments | Start an MNTEST assessment |
GET | /v1/nature/subjects/{id}/assessments/{aid} | Get assessment status |
PATCH | /v1/nature/subjects/{id}/assessments/{aid} | Submit item responses |
GET | /v1/nature/subjects/{id}/profile | Retrieve scored profile |
Webhooks
| Event | When |
|---|---|
nature.assessment.completed | All responses received and scoring finished |
nature.profile.updated | Profile was updated (re-assessment) |
See Webhooks for setup.
Languages
Profiles are available in English (en) and French (fr). Pass ?language=fr to the profile endpoint to receive narrative content in French. If no French profile exists, the API falls back to English.
The MNTEST assessment itself supports en and fr item sets — specify language when starting the assessment.
API reference
See the full API Reference for complete endpoint schemas, parameters, and response shapes.