Skip to content
Multiple Natures API

Quickstart

This guide walks through the fastest path to a working integration: running the MNTEST assessment and reading back scores.

1. Start a session

Request a magic link for the user’s email:

Terminal window
curl -X POST https://api.multiplenatures.com/auth/request \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

The user receives an email with a link. When they click it, the API sets the mn_session cookie in their browser. For server-side integrations, capture the cookie from the callback response.

2. Fetch assessment items

Retrieve the 76 MNTEST items. No auth required:

Terminal window
curl https://api.multiplenatures.com/assessments/items

Returns an array of items, each with an id, text, and dimension. Present these to the user in your UI.

3. Submit responses

Once the user has rated all items (1–5 scale), submit:

Terminal window
curl -X POST https://api.multiplenatures.com/assessments/submit \
  -H "Content-Type: application/json" \
  -H "Cookie: mn_session=YOUR_SESSION_TOKEN" \
  -d '{
    "responses": [
      { "item_id": 1, "value": 4 },
      { "item_id": 2, "value": 2 }
    ]
  }'

4. Read scores

Terminal window
curl https://api.multiplenatures.com/assessments/latest \
  -H "Cookie: mn_session=YOUR_SESSION_TOKEN"

Returns the full alignment profile: 9 Nature scores, 10 Intelligence scores, top nature, and profile metadata.

Next steps