BulkItemPreview

Per-item preview result returned from POST /api/v1/geofences/preview.

D-20: renamed from BulkRowPreview; field renamed to index (0-based). index is 0-based in API; +1 for human-facing CSV column.

Phase 191 Plan 02 (ACTIVATE-02): additive outcome_class + match-metadata fields. All new fields are Optional with safe defaults so existing clients are unaffected. outcome_class values: "success" | "low_confidence" | "interpolated" | "ambiguous" | "no_match" | "duplicate"

indexIndex (integer)required

input_addressInput Address (string)required

statusStatus (string)required

Possible values: [ok, dedup, error]

normalized_address object

anyOf

• string
• null

string

lat object

anyOf

• number
• null

number

lng object

anyOf

• number
• null

number

confidence object

anyOf

• number
• null

number

dedup_match object

anyOf

• object
• null

object

error_reason object

anyOf

• string
• null

string

error_code object

anyOf

• string
• null

string

tagsstring[]

outcome_class object

anyOf

• string
• null

string

match_type object

anyOf

• string
• null

string

interpolated object

anyOf

• boolean
• null

boolean

candidate_count object

anyOf

• integer
• null

integer

BulkItemPreview

{
  "index": 0,
  "input_address": "string",
  "status": "ok",
  "normalized_address": "string",
  "lat": 0,
  "lng": 0,
  "confidence": 0,
  "dedup_match": {},
  "error_reason": "string",
  "error_code": "string",
  "tags": [
    "string"
  ],
  "outcome_class": "string",
  "match_type": "string",
  "interpolated": true,
  "candidate_count": 0
}