Overview

nCodeCloud is a REST API for real-time Canadian address validation, correction, and standardization built on Nova's SERP-certified nCodeWS4 engine. Every response is canonical: uppercase, postal-formatted, and conforming to Canada Post addressing rules.

What it does#

The API exposes a small set of methods covering three workflows:

Capture — single-call validation and autocomplete (OneStopAnalyze).
Correct — analyze, score, and rewrite known addresses (AnalyzeAddress, AnalyzeGetAlternatives, AnalyzeRecords).
Search — partial-address lookup and reverse lookup (SearchForAddresses, SearchForNames, BrowseAddressEx).

All three workflows accept the same address-layout, analysis-mode, and correction-style parameters, so you can tune behavior to your data without learning a new shape per endpoint.

Who it's for#

Logistics & e-commerce — validate shipping addresses at checkout to cut failed deliveries.
Financial services & insurance — standardize customer records for KYC and underwriting.
Government & enterprise — bulk-cleanse existing databases and keep them clean going forward.
CRM & ERP integrations — drop-in validation in Salesforce, HubSpot, Dynamics, and similar.

A typical call#

bash

curl $NCODE_BASE/OneStopAnalyze \
-H "Authorization: $NCODE_CUSTOMER|$NCODE_KEY" \
-H "Content-Type: application/json" \
-d '{
  "AddressLayout": "oneStop Address Layout",
  "AnalysisMode": "oneStop Analysis Mode",
  "CorrectionStyle": "MIXED KYWD",
  "AddressLinesIn": [{ "strName": "", "strContent": "100 King St W Toronto ON M5X 1A9" }],
  "MaxAlternatives": 5
}'

One header, one POST, one canonical response. See Authentication for the header format and OneStopAnalyze for the full field reference.

Where to go next#

Authentication — license keys and request headers.
Quickstart — your first call in five minutes.
OneStopAnalyze — the recommended single-call validation pattern.
Status codes — V, I, C, N, F reference.
Code samples — full JavaScript / C# / Java implementations, REST and SOAP.

What the engine guarantees#

nCodeWS4 is SERP-certified by Canada Post, meaning the engine meets the Software Evaluation and Recognition Program accuracy thresholds: ≥ 98% correct categorization, ≥ 99% correction or rejection rate. Output is suitable for Statement of Accuracy (SOA) reports and the discounted postage tiers that depend on them.

The engine is also PoCAD-verified against Canada Post's Point of Call Address Data — the same reference dataset Canada Post itself uses for delivery routing. Combined, you get an address output that's not just parseable but actually deliverable.