Import NWEA MAP Growth CDFs and read stable MAP results without re-implementing dedupe.

Quickstart

One copy-paste path from demo token to MAP result read

The same hierarchical canonical API root serves the public demo tenant and real tenants. Set NWEAMAP_BASE_URL or BASE_URL to the implementation URL below. The implementation deliverable must serve this path when it lands; consumers should never use a deploy-hash URL.

export NWEAMAP_BASE_URL="https://platform3-andymontgomery-9773s-projects.vercel.app/nweamap/1edtech/implementation/api"
export BASE_URL="$NWEAMAP_BASE_URL"

TOKEN_JSON="$(curl -fsS -X POST "$BASE_URL/dev/mint?tenantId=demo")"
TOKEN="$(printf '%s' "$TOKEN_JSON" | jq -r '.token')"

for SOURCE_FILE in StudentsBySchool.csv AssessmentResults.csv ClassAssignments.csv ProgramAssignments.csv AccommodationAssignment.csv; do
  curl -fsS "$BASE_URL/dev/cdf/$SOURCE_FILE" -o "$SOURCE_FILE"
done

RUN_ID="$(date +%Y%m%d%H%M%S)"
IMPORT_JSON="$(curl -fsS -X POST "$BASE_URL/nweamap/v1/imports" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: cdf-demo-$RUN_ID" \
  -F 'manifest={"nweaAccountId":"nwea-account-demo","termName":"Spring 2025-2026"};type=application/json' \
  -F "StudentsBySchool.csv=@./StudentsBySchool.csv;type=text/csv" \
  -F "AssessmentResults.csv=@./AssessmentResults.csv;type=text/csv" \
  -F "ClassAssignments.csv=@./ClassAssignments.csv;type=text/csv" \
  -F "ProgramAssignments.csv=@./ProgramAssignments.csv;type=text/csv" \
  -F "AccommodationAssignment.csv=@./AccommodationAssignment.csv;type=text/csv")"

IMPORT_ID="$(printf '%s' "$IMPORT_JSON" | jq -r '.import.import_id')"

curl -fsS "$BASE_URL/nweamap/v1/imports/$IMPORT_ID" \
  -H "Authorization: Bearer $TOKEN" | jq '.import.status, .import.row_counts'

curl -fsS "$BASE_URL/nweamap/v1/assessment-results?nweaAccountId=nwea-account-demo&termName=Spring%202025-2026&sittingScope=test_of_record&subject=Math&limit=10" \
  -H "Authorization: Bearer $TOKEN" | jq '.data[] | {student_id, subject, test_rit_score, is_test_of_record, test_of_record_reason}'

curl -fsS "$BASE_URL/nweamap/v1/r90?subject=math&rit=239" \
  -H "Authorization: Bearer $TOKEN" | jq '{r90_grade, effective_grade, rit90_grade_band_percent, source_ref}'

Authentication

Bearer JWTs with tenant routing and NWEAMap scopes

All routes except POST /dev/mint?tenantId=demo require Authorization: Bearer <jwt>. Tokens are HS256 signed with PLATFORM_JWT_SIGNING_SECRET, carry a platform tenantId, and authorize the route through nweamap:import, nweamap:read, or nweamap:admin. The NWEA account is not a platform tenant; it is a required tenant-local data partition.

Shared platform substrate: PITD-005 auth and tenant scope and PITD-006 HTTP envelope and errors.

Errors

Typed Problems that repair imports without leaking PII

NWEAMap errors use the shared platform RFC 7807 envelope with stable NWEAMap codes, request identifiers, field errors, and row errors. Public Problems never echo raw student names, student identifiers, JWTs, or full CDF row payloads.

{
  "type": "https://platform.timeback.com/problems/nweamap/header-mismatch",
  "title": "CDF header does not match the NWEA export contract",
  "status": 400,
  "code": "nweamap:header_mismatch",
  "detail": "AssessmentResults.csv has an unexpected column at position 24.",
  "requestId": "req_018f4b4e9c7a",
  "traceId": "trace_018f4b4e9c7a",
  "fieldErrors": [
    {
      "fileName": "AssessmentResults.csv",
      "field": "TestRITScore",
      "message": "Expected header at position 24."
    }
  ],
  "rowErrors": []
}

Workflows

The workflows implementation and integrators must be able to run

API reference

Endpoints

Paths below are relative to $BASE_URL. All field names in responses either match the data dictionary's platform sidecar names or preserve NWEA CDF headers exactly.

Parameters

Shared query parameters and closed values

Data model provenance

NWEA pass-through tables plus platform import and projection objects

The customer website is not a replacement for the data dictionary. It links every endpoint and behavior back to the dictionary object that implementation must satisfy.

Surface boundary

No 1EdTech report oracle: exact MAP report cells route to Alpha

The NWEAMap 1EdTech surface is the source-fidelity layer for CDF import, pass-through read-back, import evidence, test-of-record selection, soft-delete audit, polling sync, and the R6 PowerPath RIT-to-grade reference owner. It deliberately does not publish exact MAP Quadrants report contracts, golden-cell verification, Growth X report assembly, Alpha report-specific RIT50/RIT90/Effective Grade assembly, or norms-flipped report APIs.

Architecture coverage

Commitments this customer contract inherits

These are the approved architecture commitments that control this page. If implementation discovers a contradiction, the loop must roll back to the earliest flawed upstream deliverable instead of inventing new behavior.

Implementation spec

What the implementation deliverable must ship

Source trail

Sources used to build this page

• Approved NWEAMap 1EdTech architecture
• Approved NWEAMap 1EdTech data dictionary
• loop/nweamap/artifacts/1edtech/architecture/commitments.json
• loop/nweamap/artifacts/1edtech/data_dictionary/site/nweamap-data-dictionary.json
• loop/nweamap/vendor/nwea/MAP_Export_Field_Descriptions.xlsx
• loop/nweamap/vendor/nwea/StudentsBySchool.csv
• loop/nweamap/vendor/nwea/AssessmentResults.csv
• loop/nweamap/vendor/nwea/ClassAssignments.csv
• loop/nweamap/vendor/nwea/ProgramAssignments.csv
• loop/nweamap/vendor/nwea/AccommodationAssignment.csv
• Benchmark fetched before build: Stripe API Reference