Skip to content
Multiple Natures API

MN Situation Map

The MN Situation Map is a paid diagnostic product. It runs a structured intake through the MN engine and produces a detailed PDF report delivered to the user via magic link.

Base path: /map
Auth: Session required. User must have purchased the Situation Map.
Price: $197 (public) · $177 with practitioner code

Purchase flow

The Map is purchased via the MN payment worker. On successful purchase, the user’s account is flagged as Map-eligible and the post-purchase pipeline starts automatically. You do not need to call the payment endpoint directly — direct users to the checkout URL returned by the Books catalog.

Endpoints

Submit intake

Start the diagnostic pipeline. Requires a session with Map purchase on record.

POST /map/intake
Cookie: mn_session=...
Content-Type: application/json

Request body

The intake accepts a structured questionnaire covering the user’s current work situation, role demands, energy patterns, and goals. The exact field set is managed by the intake form at multiplenatures.com — contact support for the schema if building a custom intake UI.

Response

{
  "ok": true,
  "map_id": 391,
  "status": "processing"
}

Generation runs asynchronously via a Cloudflare Workflow. Processing typically completes in 30–90 seconds.

Get map status and data

GET /map/:id
Cookie: mn_session=...

Returns the full map JSON once processing is complete, or a status object if still in progress.

Response (processing)

{
  "map_id": 391,
  "status": "processing"
}

Response (complete)

{
  "map_id": 391,
  "status": "complete",
  "completed_at": "2026-04-29T18:01:34Z",
  "top_nature": "Creating",
  "profile": { ... },
  "report_url": "https://api.multiplenatures.com/map/report?id=391&email=...&sig=..."
}

The report_url is a time-limited signed URL that serves the HTML report directly. The same URL is emailed to the user on completion.

Get PDF

GET /map/:id/pdf
Cookie: mn_session=...

Returns the map PDF as application/pdf. The PDF is pre-generated and served from R2 storage.

Submit intake draft

Save a partial intake without triggering generation. Useful for multi-step intake UIs.

POST /map/intake/draft
Cookie: mn_session=...
Content-Type: application/json

Drafts are linked to the user’s session and retrieved on subsequent page loads. Submitting a full intake via POST /map/intake discards the draft.

Delivery

On map completion, the API:

  1. Stores the PDF in R2.
  2. Emails the user a signed report URL via SES.
  3. Updates the map record to status: "complete".

Poll GET /map/:id to detect completion in your integration, or rely on the email delivery.