lcp-sdk 1.1.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/lib/lcp_sdk.rb +46 -3
  3. data/lib/schema-bundle.json +1575 -464
  4. metadata +1 -1
@@ -10,36 +10,101 @@
10
10
  "items": {
11
11
  "$ref": "core.json#/$defs/error"
12
12
  },
13
- "type": "array"
13
+ "type": "array",
14
+ "x-lcp-pii": "internal"
14
15
  },
15
16
  "lead_id": {
16
17
  "description": "Assigned lead ID, if applicable.",
17
- "type": "string"
18
+ "type": "string",
19
+ "x-lcp-pii": "internal"
20
+ },
21
+ "negotiation": {
22
+ "additionalProperties": false,
23
+ "description": "LEP-0009 \u00a75: the negotiation outcome carried on every ack for a quote/counter (and on the bid ack of a successful redemption), so a buyer never infers state from prose. Absent on a v1.1 exchange.",
24
+ "properties": {
25
+ "binding_expires_at": {
26
+ "description": "At or before the negotiation expires_at; the token is unusable at or after this instant.",
27
+ "format": "date-time",
28
+ "type": "string",
29
+ "x-lcp-pii": "internal"
30
+ },
31
+ "binding_token": {
32
+ "description": "Present only when outcome = accepted. Single-use; returned exactly once (the ack to the accepting message). The platform stores only a hash.",
33
+ "pattern": "^tok_[A-Za-z0-9_-]{32,128}$",
34
+ "type": "string",
35
+ "x-lcp-pii": "internal"
36
+ },
37
+ "currency": {
38
+ "$ref": "core.json#/$defs/currency"
39
+ },
40
+ "negotiation_id": {
41
+ "pattern": "^neg_[A-Za-z0-9_-]{8,64}$",
42
+ "type": "string",
43
+ "x-lcp-pii": "internal"
44
+ },
45
+ "outcome": {
46
+ "enum": [
47
+ "opened",
48
+ "countered",
49
+ "accepted",
50
+ "refused",
51
+ "expired",
52
+ "redeemed"
53
+ ],
54
+ "type": "string",
55
+ "x-lcp-pii": "internal"
56
+ },
57
+ "price_cents": {
58
+ "description": "The accepted, countered, or refused price; absent on a refusal that carried no price.",
59
+ "minimum": 0,
60
+ "type": "integer",
61
+ "x-lcp-pii": "internal"
62
+ },
63
+ "rounds_remaining": {
64
+ "maximum": 5,
65
+ "minimum": 0,
66
+ "type": "integer",
67
+ "x-lcp-pii": "internal"
68
+ }
69
+ },
70
+ "required": [
71
+ "negotiation_id",
72
+ "outcome",
73
+ "currency",
74
+ "rounds_remaining"
75
+ ],
76
+ "type": "object",
77
+ "x-lcp-pii": "internal"
18
78
  },
19
79
  "original_message_id": {
20
80
  "description": "ID of the message being acknowledged.",
21
81
  "format": "uuid",
22
- "type": "string"
82
+ "type": "string",
83
+ "x-lcp-pii": "internal"
23
84
  },
24
85
  "rejection_reason": {
25
86
  "$comment": "Open enum \u2014 enables publisher automation (route invalid_phone to retry, duplicate to dedup, etc.)",
26
87
  "description": "Structured rejection reason when status = REJECTED. Known values: invalid_phone, invalid_email, duplicate, out_of_geography, out_of_scope, credit_too_low, already_customer, data_quality_fail, compliance_fail, price_too_high, capacity_exceeded, consent_expired, litigator_flagged. Open enumeration.",
27
- "type": "string"
88
+ "type": "string",
89
+ "x-lcp-pii": "internal"
28
90
  },
29
91
  "request_id": {
30
92
  "description": "Server-side request ID for tracing.",
31
- "type": "string"
93
+ "type": "string",
94
+ "x-lcp-pii": "internal"
32
95
  },
33
96
  "status": {
34
97
  "enum": [
35
98
  "RECEIVED",
36
99
  "VALIDATED",
37
100
  "ACCEPTED",
101
+ "PROCESSED",
38
102
  "REJECTED",
39
103
  "DUPLICATE",
40
104
  "ERROR"
41
105
  ],
42
- "type": "string"
106
+ "type": "string",
107
+ "x-lcp-pii": "public"
43
108
  }
44
109
  },
45
110
  "required": [
@@ -49,6 +114,65 @@
49
114
  "title": "LCP Ack Message",
50
115
  "type": "object"
51
116
  },
117
+ "schemas/batch.json": {
118
+ "$id": "https://lcp.dev/schemas/batch.json",
119
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
120
+ "additionalProperties": false,
121
+ "description": "v1.2 (LEP-0001 W2-01): bounded batch submission. The batch is a loop over the single-item intake path \u2014 each item's payload is a lead payload validated by schemas/lead.json, authenticated, deduped, and persisted exactly as a single lead would be. The batch schema therefore fixes the per-item metadata (item_id, idempotency_key) and the item payload's container, never the lead's own field rules: an item whose lead payload is invalid is a per-item `rejected` receipt, not a whole-request schema failure. Created by Spear Systems (a Spear company). Open standard \u2014 Apache 2.0, free to implement.",
122
+ "properties": {
123
+ "items": {
124
+ "description": "LEP-0001 W2-01 caps a batch at 100 items; exceeding the cap is a whole-request 413 LCP-001, never a per-item rejection.",
125
+ "items": {
126
+ "additionalProperties": false,
127
+ "properties": {
128
+ "idempotency_key": {
129
+ "description": "Per-item idempotency key (LEP-0001: per-item idempotency). A replay returns the item's original result as a `duplicate` receipt (existing DUPLICATE/LCP-005 semantics at item granularity).",
130
+ "maxLength": 128,
131
+ "minLength": 1,
132
+ "type": "string",
133
+ "x-lcp-pii": "internal"
134
+ },
135
+ "item_id": {
136
+ "description": "Stable per-item identifier, echoed in that item's receipt. It also seeds the synthesized lead envelope's deterministic message id, so a replay of the same item reuses the same message.",
137
+ "maxLength": 64,
138
+ "minLength": 1,
139
+ "type": "string",
140
+ "x-lcp-pii": "internal"
141
+ },
142
+ "payload": {
143
+ "description": "A full-PII lead payload \u2014 the root object of schemas/lead.json, never an envelope and never a ping payload. It is validated per item against schemas/lead.json and the lifecycle intake rules; an invalid payload rejects that item only.",
144
+ "type": "object",
145
+ "x-lcp-pii": "restricted"
146
+ }
147
+ },
148
+ "required": [
149
+ "item_id",
150
+ "idempotency_key",
151
+ "payload"
152
+ ],
153
+ "type": "object",
154
+ "x-lcp-pii": "restricted"
155
+ },
156
+ "maxItems": 100,
157
+ "minItems": 1,
158
+ "type": "array",
159
+ "x-lcp-pii": "restricted"
160
+ },
161
+ "request_id": {
162
+ "description": "Caller-supplied request identifier, echoed in the per-item response so a client can correlate the receipt list with its own submission record.",
163
+ "maxLength": 64,
164
+ "minLength": 1,
165
+ "type": "string",
166
+ "x-lcp-pii": "internal"
167
+ }
168
+ },
169
+ "required": [
170
+ "request_id",
171
+ "items"
172
+ ],
173
+ "title": "LCP Batch Message",
174
+ "type": "object"
175
+ },
52
176
  "schemas/bid.json": {
53
177
  "$id": "https://lcp.dev/schemas/bid.json",
54
178
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -58,7 +182,8 @@
58
182
  "if": {
59
183
  "properties": {
60
184
  "decision": {
61
- "const": "accept"
185
+ "const": "accept",
186
+ "x-lcp-pii": "internal"
62
187
  }
63
188
  },
64
189
  "required": [
@@ -66,9 +191,18 @@
66
191
  ]
67
192
  },
68
193
  "then": {
69
- "required": [
70
- "bid_price_cents",
71
- "currency"
194
+ "anyOf": [
195
+ {
196
+ "required": [
197
+ "negotiation_binding_token"
198
+ ]
199
+ },
200
+ {
201
+ "required": [
202
+ "bid_price_cents",
203
+ "currency"
204
+ ]
205
+ }
72
206
  ]
73
207
  }
74
208
  }
@@ -78,16 +212,19 @@
78
212
  "bid_price_cents": {
79
213
  "description": "Buyer's bid price in cents. Required when decision = accept. Ignored when decision = reject or pass.",
80
214
  "minimum": 0,
81
- "type": "integer"
215
+ "type": "integer",
216
+ "x-lcp-pii": "internal"
82
217
  },
83
218
  "buyer_reference": {
84
219
  "description": "Buyer's internal reference for this bid (for tracking).",
85
- "type": "string"
220
+ "type": "string",
221
+ "x-lcp-pii": "internal"
86
222
  },
87
223
  "capacity_remaining": {
88
224
  "description": "Buyer's remaining capacity after this bid. Helps the platform route future pings. Optional.",
89
225
  "minimum": 0,
90
- "type": "integer"
226
+ "type": "integer",
227
+ "x-lcp-pii": "internal"
91
228
  },
92
229
  "currency": {
93
230
  "$ref": "core.json#/$defs/currency"
@@ -99,26 +236,62 @@
99
236
  "reject",
100
237
  "pass"
101
238
  ],
102
- "type": "string"
239
+ "type": "string",
240
+ "x-lcp-pii": "internal"
103
241
  },
104
242
  "estimated_contact_seconds": {
105
243
  "description": "Buyer's estimated time-to-contact in seconds. Used by the platform for speed-to-contact routing. Optional.",
106
244
  "minimum": 0,
107
- "type": "integer"
245
+ "type": "integer",
246
+ "x-lcp-pii": "internal"
247
+ },
248
+ "fx_expires_at": {
249
+ "description": "v1.2 (LEP-0010 \u00a73): canonical whole-second UTC end of the rate's validity; MUST be strictly later than fx_timestamp. REQUIRED with fx_rate.",
250
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
251
+ "type": "string",
252
+ "x-lcp-pii": "internal"
253
+ },
254
+ "fx_rate": {
255
+ "description": "v1.2 (LEP-0010 \u00a73): native major units per 1 settlement (offer-currency) major unit. Same direction and pattern as post.pricing.fx_rate. REQUIRED when bid.currency differs from the offer's currency; MUST NOT be relied on otherwise \u2014 on a same-currency bid the FX fields are inert and ignored for comparison (still schema-validated).",
256
+ "pattern": "^(?:[1-9][0-9]*\\.[0-9]{6,12}|0\\.[0-9]*[1-9][0-9]{5,11})$",
257
+ "type": "string",
258
+ "x-lcp-pii": "internal"
259
+ },
260
+ "fx_source": {
261
+ "description": "v1.2 (LEP-0010 \u00a73): named rate provider, or the literal 'bilateral' for a rate the two parties agreed directly. Compared by exact byte equality. REQUIRED with fx_rate.",
262
+ "maxLength": 64,
263
+ "minLength": 1,
264
+ "type": "string",
265
+ "x-lcp-pii": "internal"
266
+ },
267
+ "fx_timestamp": {
268
+ "description": "v1.2 (LEP-0010 \u00a73): canonical whole-second UTC instant the rate was observed (LEP-0002 canonical form). REQUIRED with fx_rate.",
269
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
270
+ "type": "string",
271
+ "x-lcp-pii": "internal"
272
+ },
273
+ "negotiation_binding_token": {
274
+ "description": "v1.2 (LEP-0009 C7): single-use token returned on a negotiation accept. It replaces bid_price_cents on this bid (the token carries the agreed price); a sender presents it only toward a receiver advertising `negotiation` and a parsed lcp_versions element of 1.2.0 or later.",
275
+ "pattern": "^tok_[A-Za-z0-9_-]{32,128}$",
276
+ "type": "string",
277
+ "x-lcp-pii": "internal"
108
278
  },
109
279
  "ping_id": {
110
280
  "description": "ID of the ping being responded to.",
111
- "type": "string"
281
+ "type": "string",
282
+ "x-lcp-pii": "internal"
112
283
  },
113
284
  "reject_reason": {
114
285
  "description": "Why the buyer rejected (e.g. out_of_hours, capacity_full, vertical_mismatch, price_too_low). Open enumeration. Optional.",
115
- "type": "string"
286
+ "type": "string",
287
+ "x-lcp-pii": "internal"
116
288
  },
117
289
  "slots_claimed": {
118
290
  "description": "v1.1 (LEP-0003 \u00a72): buyer slots this buyer claims if selected. The claim is a request, not a reservation \u2014 the platform awards slots at post time (delivery is the claim event; bids are non-binding). Only meaningful with decision 'accept'; absent = 1. Capped at exactly 1 for v1.1: multi-slot agency claims (N > 1) have no delivery path on the per-(lead, offer) award guard and no awarded-count wire signal, so they are deferred (LEP-0003 Deferred questions, #153 T5) \u2014 this schema enforces maximum: 1 now. Capability-gated (SPEC.md \u00a78): senders MUST NOT include v1.1 slot fields toward receivers whose lcp_versions advertisement does not parse to major == 1, minor >= 1.",
119
291
  "maximum": 1,
120
292
  "minimum": 1,
121
- "type": "integer"
293
+ "type": "integer",
294
+ "x-lcp-pii": "internal"
122
295
  }
123
296
  },
124
297
  "required": [
@@ -147,64 +320,79 @@
147
320
  "additionalProperties": false,
148
321
  "properties": {
149
322
  "id": {
150
- "type": "string"
323
+ "type": "string",
324
+ "x-lcp-pii": "internal"
151
325
  },
152
326
  "name": {
153
- "type": "string"
327
+ "type": "string",
328
+ "x-lcp-pii": "contact"
154
329
  }
155
330
  },
156
- "type": "object"
331
+ "type": "object",
332
+ "x-lcp-pii": "contact"
157
333
  },
158
334
  "call_id": {
159
335
  "description": "Unique call identifier.",
160
- "type": "string"
336
+ "type": "string",
337
+ "x-lcp-pii": "internal"
161
338
  },
162
339
  "caller_phone_hash": {
163
340
  "pattern": "^[a-f0-9]{64}$",
164
- "type": "string"
341
+ "type": "string",
342
+ "x-lcp-pii": "contact"
165
343
  },
166
344
  "did": {
167
345
  "description": "Dialed number (Direct Inward Dial) \u2014 the tracking number the consumer called.",
168
- "type": "string"
346
+ "type": "string",
347
+ "x-lcp-pii": "internal"
169
348
  },
170
349
  "direction": {
171
350
  "enum": [
172
351
  "inbound",
173
352
  "outbound"
174
353
  ],
175
- "type": "string"
354
+ "type": "string",
355
+ "x-lcp-pii": "internal"
176
356
  },
177
357
  "disposition": {
178
- "type": "string"
358
+ "type": "string",
359
+ "x-lcp-pii": "internal"
179
360
  },
180
361
  "durations": {
181
362
  "additionalProperties": false,
182
363
  "properties": {
183
364
  "agent_seconds": {
184
365
  "minimum": 0,
185
- "type": "integer"
366
+ "type": "integer",
367
+ "x-lcp-pii": "internal"
186
368
  },
187
369
  "hold_seconds": {
188
370
  "minimum": 0,
189
- "type": "integer"
371
+ "type": "integer",
372
+ "x-lcp-pii": "internal"
190
373
  },
191
374
  "ivr_seconds": {
192
375
  "minimum": 0,
193
- "type": "integer"
376
+ "type": "integer",
377
+ "x-lcp-pii": "internal"
194
378
  },
195
379
  "total_seconds": {
196
380
  "minimum": 0,
197
- "type": "integer"
381
+ "type": "integer",
382
+ "x-lcp-pii": "internal"
198
383
  }
199
384
  },
200
- "type": "object"
385
+ "type": "object",
386
+ "x-lcp-pii": "internal"
201
387
  },
202
388
  "forwarded_to": {
203
389
  "description": "Number the call was forwarded to (buyer's destination number). E.164.",
204
- "type": "string"
390
+ "type": "string",
391
+ "x-lcp-pii": "internal"
205
392
  },
206
393
  "hangup_cause": {
207
- "type": "string"
394
+ "type": "string",
395
+ "x-lcp-pii": "internal"
208
396
  },
209
397
  "ivr": {
210
398
  "additionalProperties": true,
@@ -212,85 +400,104 @@
212
400
  "properties": {
213
401
  "abandoned": {
214
402
  "description": "True if the caller dropped during IVR before reaching an agent.",
215
- "type": "boolean"
403
+ "type": "boolean",
404
+ "x-lcp-pii": "internal"
216
405
  },
217
406
  "digits": {
218
407
  "description": "DTMF digits pressed during IVR.",
219
- "type": "string"
408
+ "type": "string",
409
+ "x-lcp-pii": "restricted"
220
410
  },
221
411
  "language": {
222
412
  "description": "IVR language selected (BCP-47 tag, e.g. 'en-AU', 'es-US').",
223
- "type": "string"
413
+ "type": "string",
414
+ "x-lcp-pii": "internal"
224
415
  },
225
416
  "menu_options_selected": {
226
417
  "description": "Ordered list of menu option labels selected.",
227
418
  "items": {
228
419
  "type": "string"
229
420
  },
230
- "type": "array"
421
+ "type": "array",
422
+ "x-lcp-pii": "internal"
231
423
  },
232
424
  "path": {
233
425
  "description": "IVR menu path taken (e.g. 'sales > mortgage > refinance').",
234
- "type": "string"
426
+ "type": "string",
427
+ "x-lcp-pii": "internal"
235
428
  }
236
429
  },
237
- "type": "object"
430
+ "type": "object",
431
+ "x-lcp-pii": "restricted"
238
432
  },
239
433
  "queue": {
240
434
  "additionalProperties": false,
241
435
  "description": "Call queue that handled this call.",
242
436
  "properties": {
243
437
  "id": {
244
- "type": "string"
438
+ "type": "string",
439
+ "x-lcp-pii": "internal"
245
440
  },
246
441
  "name": {
247
- "type": "string"
442
+ "type": "string",
443
+ "x-lcp-pii": "internal"
248
444
  }
249
445
  },
250
- "type": "object"
446
+ "type": "object",
447
+ "x-lcp-pii": "internal"
251
448
  },
252
449
  "recording": {
253
450
  "additionalProperties": false,
254
451
  "properties": {
255
452
  "storage_ref": {
256
- "type": "string"
453
+ "type": "string",
454
+ "x-lcp-pii": "restricted"
257
455
  },
258
456
  "transcript_url": {
259
457
  "format": "uri",
260
- "type": "string"
458
+ "type": "string",
459
+ "x-lcp-pii": "restricted"
261
460
  },
262
461
  "url": {
263
462
  "format": "uri",
264
- "type": "string"
463
+ "type": "string",
464
+ "x-lcp-pii": "restricted"
265
465
  }
266
466
  },
267
- "type": "object"
467
+ "type": "object",
468
+ "x-lcp-pii": "restricted"
268
469
  },
269
470
  "started_at": {
270
471
  "format": "date-time",
271
- "type": "string"
472
+ "type": "string",
473
+ "x-lcp-pii": "internal"
272
474
  },
273
475
  "status": {
274
476
  "$comment": "Open enumeration per SPEC.md \u00a76.",
275
477
  "description": "OPEN ENUMERATION \u2014 known values: answered, no_answer, busy, failed, voicemail. Unknown values MUST be stored and passed through.",
276
- "type": "string"
478
+ "type": "string",
479
+ "x-lcp-pii": "internal"
277
480
  },
278
481
  "tracking_number": {
279
482
  "description": "Tracking/marketing number assigned to this campaign (may differ from DID if call was routed through a tracking pool). E.164.",
280
- "type": "string"
483
+ "type": "string",
484
+ "x-lcp-pii": "internal"
281
485
  },
282
486
  "transferred_from": {
283
487
  "additionalProperties": false,
284
488
  "description": "Present if this call was transferred from another call/queue.",
285
489
  "properties": {
286
490
  "original_call_id": {
287
- "type": "string"
491
+ "type": "string",
492
+ "x-lcp-pii": "internal"
288
493
  },
289
494
  "transfer_reason": {
290
- "type": "string"
495
+ "type": "string",
496
+ "x-lcp-pii": "internal"
291
497
  }
292
498
  },
293
- "type": "object"
499
+ "type": "object",
500
+ "x-lcp-pii": "internal"
294
501
  }
295
502
  },
296
503
  "required": [
@@ -299,12 +506,14 @@
299
506
  "started_at"
300
507
  ],
301
508
  "title": "Call Detail Block",
302
- "type": "object"
509
+ "type": "object",
510
+ "x-lcp-pii": "restricted"
303
511
  },
304
512
  "channel": {
305
513
  "const": "call",
306
514
  "description": "Always 'call' for call messages.",
307
- "type": "string"
515
+ "type": "string",
516
+ "x-lcp-pii": "internal"
308
517
  },
309
518
  "compliance": {
310
519
  "$ref": "core.json#/$defs/compliance"
@@ -319,10 +528,12 @@
319
528
  "$ref": "core.json#/$defs/expiry"
320
529
  },
321
530
  "external_id": {
322
- "type": "string"
531
+ "type": "string",
532
+ "x-lcp-pii": "internal"
323
533
  },
324
534
  "lead_id": {
325
- "type": "string"
535
+ "type": "string",
536
+ "x-lcp-pii": "internal"
326
537
  },
327
538
  "location": {
328
539
  "$ref": "core.json#/$defs/location"
@@ -336,7 +547,8 @@
336
547
  "submitted_at": {
337
548
  "description": "When the call was initiated (distinct from provenance.received_at).",
338
549
  "format": "date-time",
339
- "type": "string"
550
+ "type": "string",
551
+ "x-lcp-pii": "internal"
340
552
  }
341
553
  },
342
554
  "required": [
@@ -359,32 +571,38 @@
359
571
  "properties": {
360
572
  "attachment_id": {
361
573
  "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$",
362
- "type": "string"
574
+ "type": "string",
575
+ "x-lcp-pii": "internal"
363
576
  },
364
577
  "content_type": {
365
578
  "pattern": "^[^;\\s]+/[^;\\s]+$",
366
- "type": "string"
579
+ "type": "string",
580
+ "x-lcp-pii": "internal"
367
581
  },
368
582
  "created_at": {
369
583
  "format": "date-time",
370
- "type": "string"
584
+ "type": "string",
585
+ "x-lcp-pii": "internal"
371
586
  },
372
587
  "encryption": {
373
588
  "enum": [
374
589
  "application_encrypted",
375
590
  "provider_encrypted"
376
591
  ],
377
- "type": "string"
592
+ "type": "string",
593
+ "x-lcp-pii": "internal"
378
594
  },
379
595
  "expires_at": {
380
596
  "format": "date-time",
381
- "type": "string"
597
+ "type": "string",
598
+ "x-lcp-pii": "internal"
382
599
  },
383
600
  "filename": {
384
601
  "maxLength": 255,
385
602
  "minLength": 1,
386
603
  "pattern": "^[^/\\\\]+$",
387
- "type": "string"
604
+ "type": "string",
605
+ "x-lcp-pii": "restricted"
388
606
  },
389
607
  "malware_scan": {
390
608
  "additionalProperties": false,
@@ -393,18 +611,21 @@
393
611
  "engine": {
394
612
  "maxLength": 100,
395
613
  "minLength": 1,
396
- "type": "string"
614
+ "type": "string",
615
+ "x-lcp-pii": "internal"
397
616
  },
398
617
  "scanned_at": {
399
618
  "format": "date-time",
400
- "type": "string"
619
+ "type": "string",
620
+ "x-lcp-pii": "internal"
401
621
  },
402
622
  "status": {
403
623
  "enum": [
404
624
  "clean",
405
625
  "not_scanned"
406
626
  ],
407
- "type": "string"
627
+ "type": "string",
628
+ "x-lcp-pii": "internal"
408
629
  }
409
630
  },
410
631
  "required": [
@@ -412,31 +633,37 @@
412
633
  "engine",
413
634
  "scanned_at"
414
635
  ],
415
- "type": "object"
636
+ "type": "object",
637
+ "x-lcp-pii": "internal"
416
638
  },
417
639
  "purpose": {
418
640
  "maxLength": 100,
419
641
  "minLength": 1,
420
- "type": "string"
642
+ "type": "string",
643
+ "x-lcp-pii": "internal"
421
644
  },
422
645
  "residency": {
423
646
  "description": "Country or deployment region where the attachment bytes are stored and scanned.",
424
647
  "pattern": "^[A-Z0-9][A-Z0-9._-]{1,31}$",
425
- "type": "string"
648
+ "type": "string",
649
+ "x-lcp-pii": "internal"
426
650
  },
427
651
  "sha256": {
428
652
  "pattern": "^[a-f0-9]{64}$",
429
- "type": "string"
653
+ "type": "string",
654
+ "x-lcp-pii": "internal"
430
655
  },
431
656
  "size_bytes": {
432
657
  "maximum": 104857600,
433
658
  "minimum": 1,
434
- "type": "integer"
659
+ "type": "integer",
660
+ "x-lcp-pii": "internal"
435
661
  },
436
662
  "storage_ref": {
437
663
  "maxLength": 512,
438
664
  "minLength": 1,
439
- "type": "string"
665
+ "type": "string",
666
+ "x-lcp-pii": "restricted"
440
667
  }
441
668
  },
442
669
  "required": [
@@ -452,16 +679,19 @@
452
679
  "type": "object"
453
680
  },
454
681
  "maxItems": 50,
455
- "type": "array"
682
+ "type": "array",
683
+ "x-lcp-pii": "restricted"
456
684
  },
457
685
  "attributes": {
458
686
  "description": "Vertical-specific fields. Shape defined by per-vertical JSON Schema in verticals/.",
459
687
  "properties": {
460
688
  "schema_version": {
461
- "type": "string"
689
+ "type": "string",
690
+ "x-lcp-pii": "public"
462
691
  },
463
692
  "vertical": {
464
- "type": "string"
693
+ "type": "string",
694
+ "x-lcp-pii": "public"
465
695
  }
466
696
  },
467
697
  "required": [
@@ -469,50 +699,60 @@
469
699
  "schema_version"
470
700
  ],
471
701
  "title": "Attributes",
472
- "type": "object"
702
+ "type": "object",
703
+ "x-lcp-pii": "internal"
473
704
  },
474
705
  "channel": {
475
706
  "description": "Open enumeration of lead channels.",
476
707
  "title": "Lead Channel",
477
- "type": "string"
708
+ "type": "string",
709
+ "x-lcp-pii": "internal"
478
710
  },
479
711
  "compliance": {
480
712
  "additionalProperties": false,
481
713
  "description": "Consent and regulatory compliance evidence.",
482
714
  "properties": {
483
715
  "call_recording_id": {
484
- "type": "string"
716
+ "type": "string",
717
+ "x-lcp-pii": "restricted"
485
718
  },
486
719
  "consent_evidence": {
487
720
  "items": {
488
721
  "$ref": "core.json#/$defs/consent_evidence_entry"
489
722
  },
490
- "type": "array"
723
+ "type": "array",
724
+ "x-lcp-pii": "restricted"
491
725
  },
492
726
  "consent_expires_at": {
493
727
  "format": "date-time",
494
- "type": "string"
728
+ "type": "string",
729
+ "x-lcp-pii": "internal"
495
730
  },
496
731
  "consent_purposes": {
497
732
  "description": "What was consented to (e.g. calls, sms, email, share_with_partners).",
498
733
  "items": {
499
734
  "type": "string"
500
735
  },
501
- "type": "array"
736
+ "type": "array",
737
+ "x-lcp-pii": "internal"
502
738
  },
503
739
  "consent_source_url": {
504
740
  "format": "uri",
505
- "type": "string"
741
+ "type": "string",
742
+ "x-lcp-pii": "restricted"
506
743
  },
507
744
  "consent_text_version": {
508
- "type": "string"
745
+ "type": "string",
746
+ "x-lcp-pii": "internal"
509
747
  },
510
748
  "consent_timestamp": {
511
749
  "format": "date-time",
512
- "type": "string"
750
+ "type": "string",
751
+ "x-lcp-pii": "internal"
513
752
  },
514
753
  "dnc_checked": {
515
- "type": "boolean"
754
+ "type": "boolean",
755
+ "x-lcp-pii": "internal"
516
756
  },
517
757
  "otp": {
518
758
  "additionalProperties": false,
@@ -520,7 +760,8 @@
520
760
  "properties": {
521
761
  "attempts": {
522
762
  "minimum": 1,
523
- "type": "integer"
763
+ "type": "integer",
764
+ "x-lcp-pii": "internal"
524
765
  },
525
766
  "channel": {
526
767
  "enum": [
@@ -528,21 +769,26 @@
528
769
  "email",
529
770
  "voice"
530
771
  ],
531
- "type": "string"
772
+ "type": "string",
773
+ "x-lcp-pii": "internal"
532
774
  },
533
775
  "verified_at": {
534
776
  "format": "date-time",
535
- "type": "string"
777
+ "type": "string",
778
+ "x-lcp-pii": "internal"
536
779
  },
537
780
  "verified_value_hash": {
538
- "type": "string"
781
+ "type": "string",
782
+ "x-lcp-pii": "contact"
539
783
  }
540
784
  },
541
- "type": "object"
785
+ "type": "object",
786
+ "x-lcp-pii": "restricted"
542
787
  },
543
788
  "otp_verified": {
544
789
  "description": "One-time-passcode verified.",
545
- "type": "boolean"
790
+ "type": "boolean",
791
+ "x-lcp-pii": "internal"
546
792
  },
547
793
  "scrubs": {
548
794
  "items": {
@@ -550,13 +796,16 @@
550
796
  "properties": {
551
797
  "checked_at": {
552
798
  "format": "date-time",
553
- "type": "string"
799
+ "type": "string",
800
+ "x-lcp-pii": "internal"
554
801
  },
555
802
  "details": {
556
- "type": "string"
803
+ "type": "string",
804
+ "x-lcp-pii": "restricted"
557
805
  },
558
806
  "provider": {
559
- "type": "string"
807
+ "type": "string",
808
+ "x-lcp-pii": "internal"
560
809
  },
561
810
  "result": {
562
811
  "enum": [
@@ -565,10 +814,12 @@
565
814
  "blocked",
566
815
  "not_checked"
567
816
  ],
568
- "type": "string"
817
+ "type": "string",
818
+ "x-lcp-pii": "internal"
569
819
  },
570
820
  "type": {
571
- "type": "string"
821
+ "type": "string",
822
+ "x-lcp-pii": "internal"
572
823
  }
573
824
  },
574
825
  "required": [
@@ -577,14 +828,17 @@
577
828
  ],
578
829
  "type": "object"
579
830
  },
580
- "type": "array"
831
+ "type": "array",
832
+ "x-lcp-pii": "restricted"
581
833
  },
582
834
  "session_capture_id": {
583
- "type": "string"
835
+ "type": "string",
836
+ "x-lcp-pii": "restricted"
584
837
  }
585
838
  },
586
839
  "title": "Compliance",
587
- "type": "object"
840
+ "type": "object",
841
+ "x-lcp-pii": "restricted"
588
842
  },
589
843
  "consent_evidence_entry": {
590
844
  "additionalProperties": false,
@@ -592,15 +846,18 @@
592
846
  "properties": {
593
847
  "provider": {
594
848
  "description": "Vendor or system (e.g. jornaya, trustedform, internal).",
595
- "type": "string"
849
+ "type": "string",
850
+ "x-lcp-pii": "internal"
596
851
  },
597
852
  "token_or_url": {
598
853
  "description": "Verification token, certificate URL, or reference.",
599
- "type": "string"
854
+ "type": "string",
855
+ "x-lcp-pii": "restricted"
600
856
  },
601
857
  "type": {
602
858
  "description": "Consent framework or evidence type (e.g. tcpa_consent, gdpr_opt_in).",
603
- "type": "string"
859
+ "type": "string",
860
+ "x-lcp-pii": "internal"
604
861
  }
605
862
  },
606
863
  "required": [
@@ -609,7 +866,8 @@
609
866
  "token_or_url"
610
867
  ],
611
868
  "title": "Consent Evidence Entry",
612
- "type": "object"
869
+ "type": "object",
870
+ "x-lcp-pii": "restricted"
613
871
  },
614
872
  "consumer": {
615
873
  "additionalProperties": false,
@@ -641,41 +899,50 @@
641
899
  "dob": {
642
900
  "description": "Sensitive.",
643
901
  "format": "date",
644
- "type": "string"
902
+ "type": "string",
903
+ "x-lcp-pii": "restricted"
645
904
  },
646
905
  "email": {
647
906
  "format": "email",
648
- "type": "string"
907
+ "type": "string",
908
+ "x-lcp-pii": "contact"
649
909
  },
650
910
  "email_hash": {
651
911
  "description": "HMAC-SHA256(shared_secret, normalized_email). For dedup in ping. Same per-pair model as phone_hash.",
652
912
  "pattern": "^[a-f0-9]{64}$",
653
- "type": "string"
913
+ "type": "string",
914
+ "x-lcp-pii": "contact"
654
915
  },
655
916
  "first_name": {
656
- "type": "string"
917
+ "type": "string",
918
+ "x-lcp-pii": "contact"
657
919
  },
658
920
  "full_name": {
659
921
  "description": "Unstructured name \u2014 use when Western given/family splitting does not apply.",
660
- "type": "string"
922
+ "type": "string",
923
+ "x-lcp-pii": "contact"
661
924
  },
662
925
  "last_name": {
663
- "type": "string"
926
+ "type": "string",
927
+ "x-lcp-pii": "contact"
664
928
  },
665
929
  "locale": {
666
930
  "description": "BCP-47 language tag (e.g. en-AU, es-US).",
667
931
  "pattern": "^[a-z]{2,3}(-[A-Z][a-z]{3})?(-([A-Z]{2}|[0-9]{3}))?$",
668
- "type": "string"
932
+ "type": "string",
933
+ "x-lcp-pii": "internal"
669
934
  },
670
935
  "phone": {
671
936
  "description": "E.164 format.",
672
937
  "pattern": "^\\+[1-9]\\d{1,14}$",
673
- "type": "string"
938
+ "type": "string",
939
+ "x-lcp-pii": "contact"
674
940
  },
675
941
  "phone_hash": {
676
942
  "description": "HMAC-SHA256(shared_secret, e164). 64 hex chars.",
677
943
  "pattern": "^[a-f0-9]{64}$",
678
- "type": "string"
944
+ "type": "string",
945
+ "x-lcp-pii": "contact"
679
946
  },
680
947
  "preferred_contact_method": {
681
948
  "description": "Consumer's preferred contact method. Affects contact strategy and compliance.",
@@ -685,47 +952,57 @@
685
952
  "sms",
686
953
  "any"
687
954
  ],
688
- "type": "string"
955
+ "type": "string",
956
+ "x-lcp-pii": "contact"
689
957
  },
690
958
  "secondary_phone": {
691
959
  "description": "Secondary phone (work, spouse, alternate). E.164. Optional.",
692
960
  "pattern": "^\\+[1-9]\\d{1,14}$",
693
- "type": "string"
961
+ "type": "string",
962
+ "x-lcp-pii": "contact"
694
963
  }
695
964
  },
696
965
  "title": "Consumer",
697
- "type": "object"
966
+ "type": "object",
967
+ "x-lcp-pii": "restricted"
698
968
  },
699
969
  "currency": {
700
970
  "pattern": "^[A-Z]{3}$",
701
- "type": "string"
971
+ "type": "string",
972
+ "x-lcp-pii": "public"
702
973
  },
703
974
  "error": {
704
975
  "additionalProperties": false,
705
976
  "properties": {
706
977
  "code": {
707
978
  "pattern": "^LCP-\\d{3}$",
708
- "type": "string"
979
+ "type": "string",
980
+ "x-lcp-pii": "public"
709
981
  },
710
982
  "details": {
711
983
  "additionalProperties": true,
712
- "type": "object"
984
+ "type": "object",
985
+ "x-lcp-pii": "internal"
713
986
  },
714
987
  "field": {
715
- "type": "string"
988
+ "type": "string",
989
+ "x-lcp-pii": "internal"
716
990
  },
717
991
  "message": {
718
- "type": "string"
992
+ "type": "string",
993
+ "x-lcp-pii": "internal"
719
994
  },
720
995
  "name": {
721
- "type": "string"
996
+ "type": "string",
997
+ "x-lcp-pii": "public"
722
998
  }
723
999
  },
724
1000
  "required": [
725
1001
  "code",
726
1002
  "message"
727
1003
  ],
728
- "type": "object"
1004
+ "type": "object",
1005
+ "x-lcp-pii": "internal"
729
1006
  },
730
1007
  "errors_array": {
731
1008
  "additionalProperties": false,
@@ -735,13 +1012,15 @@
735
1012
  "$ref": "core.json#/$defs/error"
736
1013
  },
737
1014
  "minItems": 1,
738
- "type": "array"
1015
+ "type": "array",
1016
+ "x-lcp-pii": "internal"
739
1017
  }
740
1018
  },
741
1019
  "required": [
742
1020
  "errors"
743
1021
  ],
744
- "type": "object"
1022
+ "type": "object",
1023
+ "x-lcp-pii": "internal"
745
1024
  },
746
1025
  "exclusivity": {
747
1026
  "additionalProperties": false,
@@ -752,14 +1031,17 @@
752
1031
  "exclusive",
753
1032
  "shared"
754
1033
  ],
755
- "type": "string"
1034
+ "type": "string",
1035
+ "x-lcp-pii": "internal"
756
1036
  },
757
1037
  "max_buyers": {
758
1038
  "minimum": 1,
759
- "type": "integer"
1039
+ "type": "integer",
1040
+ "x-lcp-pii": "internal"
760
1041
  }
761
1042
  },
762
- "type": "object"
1043
+ "type": "object",
1044
+ "x-lcp-pii": "internal"
763
1045
  },
764
1046
  "expiry": {
765
1047
  "additionalProperties": false,
@@ -778,14 +1060,17 @@
778
1060
  "properties": {
779
1061
  "expires_at": {
780
1062
  "format": "date-time",
781
- "type": "string"
1063
+ "type": "string",
1064
+ "x-lcp-pii": "internal"
782
1065
  },
783
1066
  "ttl_seconds": {
784
1067
  "minimum": 1,
785
- "type": "integer"
1068
+ "type": "integer",
1069
+ "x-lcp-pii": "internal"
786
1070
  }
787
1071
  },
788
- "type": "object"
1072
+ "type": "object",
1073
+ "x-lcp-pii": "internal"
789
1074
  },
790
1075
  "location": {
791
1076
  "additionalProperties": false,
@@ -803,31 +1088,44 @@
803
1088
  ],
804
1089
  "properties": {
805
1090
  "city": {
806
- "type": "string"
1091
+ "type": "string",
1092
+ "x-lcp-pii": "internal"
807
1093
  },
808
1094
  "country_code": {
809
1095
  "description": "ISO 3166-1 alpha-2. Required.",
810
1096
  "pattern": "^[A-Z]{2}$",
811
- "type": "string"
1097
+ "type": "string",
1098
+ "x-lcp-pii": "internal"
812
1099
  },
813
1100
  "postal_code": {
814
1101
  "description": "Per-country format.",
815
- "type": "string"
1102
+ "type": "string",
1103
+ "x-lcp-pii": "internal"
816
1104
  },
817
1105
  "state_region": {
818
1106
  "description": "Per-country validation registry (state, province, region).",
819
- "type": "string"
1107
+ "type": "string",
1108
+ "x-lcp-pii": "internal"
1109
+ },
1110
+ "street_address": {
1111
+ "description": "Residential street address. Not ping-safe; omitted from ping payloads.",
1112
+ "maxLength": 200,
1113
+ "minLength": 1,
1114
+ "type": "string",
1115
+ "x-lcp-pii": "contact"
820
1116
  },
821
1117
  "timezone": {
822
1118
  "description": "IANA timezone (e.g. Australia/Sydney).",
823
- "type": "string"
1119
+ "type": "string",
1120
+ "x-lcp-pii": "internal"
824
1121
  }
825
1122
  },
826
1123
  "required": [
827
1124
  "country_code"
828
1125
  ],
829
1126
  "title": "Location",
830
- "type": "object"
1127
+ "type": "object",
1128
+ "x-lcp-pii": "contact"
831
1129
  },
832
1130
  "provenance": {
833
1131
  "additionalProperties": false,
@@ -835,21 +1133,25 @@
835
1133
  "properties": {
836
1134
  "acquisition_method": {
837
1135
  "description": "Open enumeration of acquisition methods.",
838
- "type": "string"
1136
+ "type": "string",
1137
+ "x-lcp-pii": "internal"
839
1138
  },
840
1139
  "agent": {
841
1140
  "additionalProperties": false,
842
1141
  "properties": {
843
1142
  "acting_for": {
844
- "type": "string"
1143
+ "type": "string",
1144
+ "x-lcp-pii": "internal"
845
1145
  },
846
1146
  "agent_id": {
847
- "type": "string"
1147
+ "type": "string",
1148
+ "x-lcp-pii": "internal"
848
1149
  },
849
1150
  "attestation": {
850
1151
  "maxLength": 8192,
851
1152
  "pattern": "^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$",
852
- "type": "string"
1153
+ "type": "string",
1154
+ "x-lcp-pii": "restricted"
853
1155
  }
854
1156
  },
855
1157
  "required": [
@@ -857,79 +1159,107 @@
857
1159
  "acting_for",
858
1160
  "attestation"
859
1161
  ],
860
- "type": "object"
1162
+ "type": "object",
1163
+ "x-lcp-pii": "restricted"
861
1164
  },
862
1165
  "brand_id": {
863
1166
  "description": "Publisher-owned brand identifier.",
864
- "type": "string"
1167
+ "type": "string",
1168
+ "x-lcp-pii": "internal"
865
1169
  },
866
1170
  "campaign_id": {
867
- "type": "string"
1171
+ "type": "string",
1172
+ "x-lcp-pii": "internal"
868
1173
  },
869
1174
  "creative_id": {
870
- "type": "string"
1175
+ "type": "string",
1176
+ "x-lcp-pii": "internal"
871
1177
  },
872
1178
  "flow_key": {
873
- "type": "string"
1179
+ "type": "string",
1180
+ "x-lcp-pii": "internal"
874
1181
  },
875
1182
  "form_id": {
876
1183
  "description": "Stable form or flow identifier.",
877
- "type": "string"
1184
+ "type": "string",
1185
+ "x-lcp-pii": "internal"
878
1186
  },
879
1187
  "funnel_key": {
880
- "type": "string"
1188
+ "type": "string",
1189
+ "x-lcp-pii": "internal"
881
1190
  },
882
1191
  "incentive_type": {
883
- "type": "string"
1192
+ "type": "string",
1193
+ "x-lcp-pii": "internal"
1194
+ },
1195
+ "ip_address": {
1196
+ "description": "Consumer IP address (IPv4 or IPv6) captured server-side. Post-only; not ping-safe. ip_hash remains the ping-safe projection.",
1197
+ "maxLength": 45,
1198
+ "minLength": 7,
1199
+ "type": "string",
1200
+ "x-lcp-pii": "contact"
884
1201
  },
885
1202
  "ip_hash": {
886
- "type": "string"
1203
+ "type": "string",
1204
+ "x-lcp-pii": "contact"
887
1205
  },
888
1206
  "is_incentivized": {
889
- "type": "boolean"
1207
+ "type": "boolean",
1208
+ "x-lcp-pii": "internal"
890
1209
  },
891
1210
  "landing_page_url": {
892
1211
  "format": "uri",
893
- "type": "string"
1212
+ "type": "string",
1213
+ "x-lcp-pii": "restricted"
894
1214
  },
895
1215
  "platform_source": {
896
- "type": "string"
1216
+ "type": "string",
1217
+ "x-lcp-pii": "internal"
897
1218
  },
898
1219
  "received_at": {
899
1220
  "format": "date-time",
900
- "type": "string"
1221
+ "type": "string",
1222
+ "x-lcp-pii": "internal"
901
1223
  },
902
1224
  "source_id": {
903
- "type": "string"
1225
+ "type": "string",
1226
+ "x-lcp-pii": "internal"
904
1227
  },
905
1228
  "source_type": {
906
1229
  "description": "Open enumeration of source types.",
907
- "type": "string"
1230
+ "type": "string",
1231
+ "x-lcp-pii": "internal"
908
1232
  },
909
1233
  "source_url": {
910
1234
  "format": "uri",
911
- "type": "string"
1235
+ "type": "string",
1236
+ "x-lcp-pii": "restricted"
912
1237
  },
913
1238
  "user_agent_hash": {
914
- "type": "string"
1239
+ "type": "string",
1240
+ "x-lcp-pii": "contact"
915
1241
  }
916
1242
  },
917
1243
  "title": "Provenance",
918
- "type": "object"
1244
+ "type": "object",
1245
+ "x-lcp-pii": "restricted"
919
1246
  },
920
1247
  "security": {
921
1248
  "additionalProperties": false,
922
1249
  "properties": {
923
1250
  "algorithm": {
924
1251
  "const": "HMAC-SHA256",
925
- "type": "string"
1252
+ "type": "string",
1253
+ "x-lcp-pii": "public"
926
1254
  },
927
1255
  "signature": {
928
- "type": "string"
1256
+ "type": "string",
1257
+ "x-lcp-pii": "restricted"
929
1258
  },
930
1259
  "timestamp": {
931
1260
  "format": "date-time",
932
- "type": "string"
1261
+ "type": "string",
1262
+ "x-lcp-pii": "internal"
933
1263
  }
934
1264
  },
935
1265
  "required": [
@@ -937,12 +1267,14 @@
937
1267
  "timestamp",
938
1268
  "algorithm"
939
1269
  ],
940
- "type": "object"
1270
+ "type": "object",
1271
+ "x-lcp-pii": "restricted"
941
1272
  },
942
1273
  "status": {
943
1274
  "description": "Open enumeration of lifecycle statuses.",
944
1275
  "title": "Lead Status",
945
- "type": "string"
1276
+ "type": "string",
1277
+ "x-lcp-pii": "internal"
946
1278
  }
947
1279
  },
948
1280
  "$id": "https://lcp.dev/schemas/core.json",
@@ -951,6 +1283,123 @@
951
1283
  "title": "LCP Core Definitions",
952
1284
  "type": "object"
953
1285
  },
1286
+ "schemas/counter.json": {
1287
+ "$id": "https://lcp.dev/schemas/counter.json",
1288
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1289
+ "additionalProperties": false,
1290
+ "allOf": [
1291
+ {
1292
+ "else": {
1293
+ "not": {
1294
+ "required": [
1295
+ "rejection_reason"
1296
+ ]
1297
+ },
1298
+ "required": [
1299
+ "price_cents"
1300
+ ]
1301
+ },
1302
+ "if": {
1303
+ "properties": {
1304
+ "decision": {
1305
+ "const": "refuse",
1306
+ "x-lcp-pii": "internal"
1307
+ }
1308
+ },
1309
+ "required": [
1310
+ "decision"
1311
+ ]
1312
+ },
1313
+ "then": {
1314
+ "not": {
1315
+ "required": [
1316
+ "price_cents"
1317
+ ]
1318
+ },
1319
+ "required": [
1320
+ "rejection_reason"
1321
+ ]
1322
+ }
1323
+ }
1324
+ ],
1325
+ "description": "Either party answers the standing negotiation message (LEP-0009). Strict allowlist: integer minor units, ISO 4217 currency, opaque ids, round counters, and closed/known reason values only. No consumer PII and no free text. Created by Spear Systems (a Spear company). Open standard \u2014 Apache 2.0, free to implement.",
1326
+ "properties": {
1327
+ "currency": {
1328
+ "$ref": "core.json#/$defs/currency"
1329
+ },
1330
+ "decision": {
1331
+ "description": "counter = move the price; accept = close at the price of the message being answered; refuse = close with a reason.",
1332
+ "enum": [
1333
+ "counter",
1334
+ "accept",
1335
+ "refuse"
1336
+ ],
1337
+ "type": "string",
1338
+ "x-lcp-pii": "internal"
1339
+ },
1340
+ "expires_at": {
1341
+ "description": "The negotiation's absolute end, unchanged. MUST NOT exceed the value set by the opening quote.",
1342
+ "format": "date-time",
1343
+ "type": "string",
1344
+ "x-lcp-pii": "internal"
1345
+ },
1346
+ "floor_price_cents": {
1347
+ "description": "Restated and checked against the negotiation's floor (LCP-100 on mismatch).",
1348
+ "minimum": 0,
1349
+ "type": "integer",
1350
+ "x-lcp-pii": "internal"
1351
+ },
1352
+ "negotiation_id": {
1353
+ "description": "MUST name an existing negotiation for this (tenant, buyer, ping) triple; otherwise unknown_negotiation (or LCP-002 when it belongs to another buyer/tenant).",
1354
+ "pattern": "^neg_[A-Za-z0-9_-]{8,64}$",
1355
+ "type": "string",
1356
+ "x-lcp-pii": "internal"
1357
+ },
1358
+ "offer_id": {
1359
+ "description": "MUST equal the negotiation's offer (LCP-100 on mismatch).",
1360
+ "minLength": 1,
1361
+ "type": "string",
1362
+ "x-lcp-pii": "internal"
1363
+ },
1364
+ "ping_id": {
1365
+ "description": "MUST equal the negotiation's ping (LCP-100 on mismatch).",
1366
+ "minLength": 1,
1367
+ "type": "string",
1368
+ "x-lcp-pii": "internal"
1369
+ },
1370
+ "price_cents": {
1371
+ "description": "Required unless decision = refuse. counter: subject to the monotone rule and at or above floor_price_cents. accept: MUST equal the price of the message it answers.",
1372
+ "minimum": 0,
1373
+ "type": "integer",
1374
+ "x-lcp-pii": "internal"
1375
+ },
1376
+ "rejection_reason": {
1377
+ "description": "Open enumeration. Required when decision = refuse; absent otherwise. Known values: below_floor_price, non_monotone_counter, round_limit_exceeded, negotiation_expired, unknown_negotiation, negotiation_closed.",
1378
+ "minLength": 1,
1379
+ "type": "string",
1380
+ "x-lcp-pii": "internal"
1381
+ },
1382
+ "rounds_remaining": {
1383
+ "description": "The sender's view of the buyer counters still available at the moment this message is sent, before it is applied. A stale value is LCP-100.",
1384
+ "maximum": 5,
1385
+ "minimum": 0,
1386
+ "type": "integer",
1387
+ "x-lcp-pii": "internal"
1388
+ }
1389
+ },
1390
+ "required": [
1391
+ "negotiation_id",
1392
+ "ping_id",
1393
+ "offer_id",
1394
+ "decision",
1395
+ "currency",
1396
+ "floor_price_cents",
1397
+ "rounds_remaining",
1398
+ "expires_at"
1399
+ ],
1400
+ "title": "LCP Counter Message",
1401
+ "type": "object"
1402
+ },
954
1403
  "schemas/envelope.json": {
955
1404
  "$id": "https://lcp.dev/schemas/envelope.json",
956
1405
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -959,6 +1408,41 @@
959
1408
  "properties": {
960
1409
  "lcp": {
961
1410
  "additionalProperties": false,
1411
+ "allOf": [
1412
+ {
1413
+ "if": {
1414
+ "properties": {
1415
+ "message": {
1416
+ "properties": {
1417
+ "type": {
1418
+ "enum": [
1419
+ "quote",
1420
+ "counter"
1421
+ ],
1422
+ "x-lcp-pii": "public"
1423
+ }
1424
+ },
1425
+ "required": [
1426
+ "type"
1427
+ ],
1428
+ "x-lcp-pii": "internal"
1429
+ }
1430
+ },
1431
+ "required": [
1432
+ "message"
1433
+ ]
1434
+ },
1435
+ "then": {
1436
+ "description": "LEP-0009 C1/C2: negotiation types exist from protocol 1.2.0 (MINOR); a later major is a different contract and never rides this pattern.",
1437
+ "properties": {
1438
+ "version": {
1439
+ "pattern": "^1\\.(?:[2-9]|[1-9][0-9]+)\\.\\d+$",
1440
+ "x-lcp-pii": "public"
1441
+ }
1442
+ }
1443
+ }
1444
+ }
1445
+ ],
962
1446
  "properties": {
963
1447
  "message": {
964
1448
  "additionalProperties": false,
@@ -968,40 +1452,48 @@
968
1452
  "type": [
969
1453
  "string",
970
1454
  "null"
971
- ]
1455
+ ],
1456
+ "x-lcp-pii": "internal"
972
1457
  },
973
1458
  "id": {
974
1459
  "description": "Unique message identifier (UUID v4).",
975
1460
  "format": "uuid",
976
- "type": "string"
1461
+ "type": "string",
1462
+ "x-lcp-pii": "internal"
977
1463
  },
978
1464
  "idempotency_key": {
979
1465
  "description": "Idempotency key \u2014 duplicate submissions with the same key return the original result.",
980
- "type": "string"
1466
+ "type": "string",
1467
+ "x-lcp-pii": "internal"
981
1468
  },
982
1469
  "receiver_id": {
983
1470
  "description": "Receiver identifier.",
984
- "type": "string"
1471
+ "type": "string",
1472
+ "x-lcp-pii": "internal"
985
1473
  },
986
1474
  "security": {
987
1475
  "$ref": "core.json#/$defs/security",
988
- "description": "Transport-neutral HMAC signature. Optional for HTTP (headers used instead); required for non-HTTP transports."
1476
+ "description": "Transport-neutral HMAC signature. Optional for HTTP (headers used instead); required for non-HTTP transports.",
1477
+ "x-lcp-pii": "restricted"
989
1478
  },
990
1479
  "sender_id": {
991
1480
  "description": "Sender identifier (publisher/platform/buyer).",
992
- "type": "string"
1481
+ "type": "string",
1482
+ "x-lcp-pii": "internal"
993
1483
  },
994
1484
  "test": {
995
1485
  "default": false,
996
1486
  "description": "Test message. Mirrored as X-LCP-Test header in the HTTP binding.",
997
- "type": "boolean"
1487
+ "type": "boolean",
1488
+ "x-lcp-pii": "public"
998
1489
  },
999
1490
  "timestamp": {
1000
1491
  "format": "date-time",
1001
- "type": "string"
1492
+ "type": "string",
1493
+ "x-lcp-pii": "internal"
1002
1494
  },
1003
1495
  "type": {
1004
- "description": "Message type. Closed enumeration \u2014 unknown types trigger LCP-006.",
1496
+ "description": "Message type. Closed enumeration \u2014 unknown types trigger LCP-006. `quote`/`counter` are the LEP-0009 negotiation types, emitted only toward a peer advertising `negotiation` and a parsed lcp_versions element of 1.2.0 or later. `subscription` is the LEP-0001 W3 registration type, emitted only toward a receiver advertising `event_subscriptions`.",
1005
1497
  "enum": [
1006
1498
  "lead",
1007
1499
  "call",
@@ -1009,9 +1501,14 @@
1009
1501
  "post",
1010
1502
  "ack",
1011
1503
  "event",
1012
- "bid"
1504
+ "bid",
1505
+ "batch",
1506
+ "quote",
1507
+ "counter",
1508
+ "subscription"
1013
1509
  ],
1014
- "type": "string"
1510
+ "type": "string",
1511
+ "x-lcp-pii": "public"
1015
1512
  }
1016
1513
  },
1017
1514
  "required": [
@@ -1023,15 +1520,18 @@
1023
1520
  "idempotency_key"
1024
1521
  ],
1025
1522
  "title": "Message Header",
1026
- "type": "object"
1523
+ "type": "object",
1524
+ "x-lcp-pii": "internal"
1027
1525
  },
1028
1526
  "payload": {
1029
- "description": "Message payload. Shape determined by message.type \u2014 see message-type schemas (lead.json, call.json, ping.json, post.json, ack.json, event.json)."
1527
+ "description": "Message payload. Shape determined by message.type \u2014 see message-type schemas (lead.json, call.json, ping.json, post.json, ack.json, event.json, bid.json, batch.json, quote.json, counter.json, subscription.json).",
1528
+ "x-lcp-pii": "computed"
1030
1529
  },
1031
1530
  "version": {
1032
1531
  "description": "Protocol semver (e.g. 1.0.0).",
1033
1532
  "pattern": "^\\d+\\.\\d+\\.\\d+$",
1034
- "type": "string"
1533
+ "type": "string",
1534
+ "x-lcp-pii": "public"
1035
1535
  }
1036
1536
  },
1037
1537
  "required": [
@@ -1039,7 +1539,8 @@
1039
1539
  "message",
1040
1540
  "payload"
1041
1541
  ],
1042
- "type": "object"
1542
+ "type": "object",
1543
+ "x-lcp-pii": "restricted"
1043
1544
  }
1044
1545
  },
1045
1546
  "required": [
@@ -1056,22 +1557,27 @@
1056
1557
  "properties": {
1057
1558
  "details": {
1058
1559
  "additionalProperties": true,
1059
- "type": "object"
1560
+ "type": "object",
1561
+ "x-lcp-pii": "restricted"
1060
1562
  },
1061
1563
  "event": {
1062
1564
  "$comment": "No enum constraint \u2014 this is an open enumeration per SPEC.md \u00a76. Receivers must accept any string value.",
1063
1565
  "description": "Lifecycle event. OPEN ENUMERATION \u2014 known values: DELIVERED, ACCEPTED, REJECTED, DISPUTED, REFUNDED, EXPIRED, CONVERTED, ARCHIVED. Unknown values MUST be stored and passed through, not rejected. Adding new values is a MINOR version bump, not breaking.",
1064
- "type": "string"
1566
+ "type": "string",
1567
+ "x-lcp-pii": "public"
1065
1568
  },
1066
1569
  "external_reference": {
1067
- "type": "string"
1570
+ "type": "string",
1571
+ "x-lcp-pii": "internal"
1068
1572
  },
1069
1573
  "lead_id": {
1070
- "type": "string"
1574
+ "type": "string",
1575
+ "x-lcp-pii": "internal"
1071
1576
  },
1072
1577
  "timestamp": {
1073
1578
  "format": "date-time",
1074
- "type": "string"
1579
+ "type": "string",
1580
+ "x-lcp-pii": "internal"
1075
1581
  }
1076
1582
  },
1077
1583
  "required": [
@@ -1109,11 +1615,13 @@
1109
1615
  "properties": {
1110
1616
  "available_from": {
1111
1617
  "description": "Local time HH:MM format (24h).",
1112
- "type": "string"
1618
+ "type": "string",
1619
+ "x-lcp-pii": "contact"
1113
1620
  },
1114
1621
  "available_to": {
1115
1622
  "description": "Local time HH:MM format (24h).",
1116
- "type": "string"
1623
+ "type": "string",
1624
+ "x-lcp-pii": "contact"
1117
1625
  },
1118
1626
  "days": {
1119
1627
  "description": "Days of week the consumer is available.",
@@ -1129,14 +1637,17 @@
1129
1637
  ],
1130
1638
  "type": "string"
1131
1639
  },
1132
- "type": "array"
1640
+ "type": "array",
1641
+ "x-lcp-pii": "contact"
1133
1642
  },
1134
1643
  "timezone": {
1135
1644
  "description": "IANA timezone for the window times (e.g. Australia/Sydney).",
1136
- "type": "string"
1645
+ "type": "string",
1646
+ "x-lcp-pii": "internal"
1137
1647
  }
1138
1648
  },
1139
- "type": "object"
1649
+ "type": "object",
1650
+ "x-lcp-pii": "contact"
1140
1651
  },
1141
1652
  "exclusivity": {
1142
1653
  "$ref": "core.json#/$defs/exclusivity"
@@ -1153,14 +1664,17 @@
1153
1664
  },
1154
1665
  "pattern": "^[a-z0-9][a-z0-9_-]*(\\.[a-z0-9][a-z0-9_-]*){2,}$"
1155
1666
  },
1156
- "type": "object"
1667
+ "type": "object",
1668
+ "x-lcp-pii": "restricted"
1157
1669
  },
1158
1670
  "external_id": {
1159
1671
  "description": "Publisher's internal lead ID.",
1160
- "type": "string"
1672
+ "type": "string",
1673
+ "x-lcp-pii": "internal"
1161
1674
  },
1162
1675
  "lead_id": {
1163
- "type": "string"
1676
+ "type": "string",
1677
+ "x-lcp-pii": "internal"
1164
1678
  },
1165
1679
  "lead_quality": {
1166
1680
  "additionalProperties": false,
@@ -1173,7 +1687,8 @@
1173
1687
  "standard",
1174
1688
  "rich"
1175
1689
  ],
1176
- "type": "string"
1690
+ "type": "string",
1691
+ "x-lcp-pii": "internal"
1177
1692
  },
1178
1693
  "duplicate_risk": {
1179
1694
  "description": "Publisher's assessment of duplicate risk based on their dedup window.",
@@ -1182,13 +1697,15 @@
1182
1697
  "medium",
1183
1698
  "high"
1184
1699
  ],
1185
- "type": "string"
1700
+ "type": "string",
1701
+ "x-lcp-pii": "internal"
1186
1702
  },
1187
1703
  "spam_risk_score": {
1188
1704
  "description": "Publisher's spam risk score (0 = clean, 100 = likely spam). Scoring methodology is publisher-defined.",
1189
1705
  "maximum": 100,
1190
1706
  "minimum": 0,
1191
- "type": "integer"
1707
+ "type": "integer",
1708
+ "x-lcp-pii": "internal"
1192
1709
  },
1193
1710
  "verification": {
1194
1711
  "additionalProperties": false,
@@ -1197,42 +1714,52 @@
1197
1714
  "email_method": {
1198
1715
  "$comment": "Open enum \u2014 new email verification services are additive.",
1199
1716
  "description": "How the email was verified. Known values: otp, smtp_check, bounce_check, briteverify, zerobounce, kickbox, none. Open enumeration.",
1200
- "type": "string"
1717
+ "type": "string",
1718
+ "x-lcp-pii": "internal"
1201
1719
  },
1202
1720
  "email_verified_at": {
1203
1721
  "format": "date-time",
1204
- "type": "string"
1722
+ "type": "string",
1723
+ "x-lcp-pii": "internal"
1205
1724
  },
1206
1725
  "email_verified_by": {
1207
1726
  "description": "Provider that performed the verification (e.g. briteverify, zerobounce, internal, publisher_otp).",
1208
- "type": "string"
1727
+ "type": "string",
1728
+ "x-lcp-pii": "internal"
1209
1729
  },
1210
1730
  "phone_method": {
1211
1731
  "$comment": "Open enum \u2014 new verification methods (e.g. new enrichment providers) are additive.",
1212
1732
  "description": "How the phone was verified. Known values: otp, carrier_lookup, call_connect, twilio_lookup, manual_call, none. Open enumeration.",
1213
- "type": "string"
1733
+ "type": "string",
1734
+ "x-lcp-pii": "internal"
1214
1735
  },
1215
1736
  "phone_verified_at": {
1216
1737
  "format": "date-time",
1217
- "type": "string"
1738
+ "type": "string",
1739
+ "x-lcp-pii": "internal"
1218
1740
  },
1219
1741
  "phone_verified_by": {
1220
1742
  "description": "Provider that performed the verification (e.g. twilio, numverify, internal, publisher_otp).",
1221
- "type": "string"
1743
+ "type": "string",
1744
+ "x-lcp-pii": "internal"
1222
1745
  }
1223
1746
  },
1224
- "type": "object"
1747
+ "type": "object",
1748
+ "x-lcp-pii": "internal"
1225
1749
  },
1226
1750
  "verified_email": {
1227
1751
  "description": "Email was verified (OTP, bounce check, or SMTP validation).",
1228
- "type": "boolean"
1752
+ "type": "boolean",
1753
+ "x-lcp-pii": "internal"
1229
1754
  },
1230
1755
  "verified_phone": {
1231
1756
  "description": "Phone number was verified (OTP, call connect, or carrier lookup).",
1232
- "type": "boolean"
1757
+ "type": "boolean",
1758
+ "x-lcp-pii": "internal"
1233
1759
  }
1234
1760
  },
1235
- "type": "object"
1761
+ "type": "object",
1762
+ "x-lcp-pii": "internal"
1236
1763
  },
1237
1764
  "location": {
1238
1765
  "$ref": "core.json#/$defs/location"
@@ -1246,7 +1773,8 @@
1246
1773
  "submitted_at": {
1247
1774
  "description": "When the consumer submitted the lead (distinct from provenance.received_at which is when the platform received it).",
1248
1775
  "format": "date-time",
1249
- "type": "string"
1776
+ "type": "string",
1777
+ "x-lcp-pii": "internal"
1250
1778
  }
1251
1779
  },
1252
1780
  "required": [
@@ -1267,18 +1795,21 @@
1267
1795
  "properties": {
1268
1796
  "available_from": {
1269
1797
  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
1270
- "type": "string"
1798
+ "type": "string",
1799
+ "x-lcp-pii": "internal"
1271
1800
  },
1272
1801
  "available_to": {
1273
1802
  "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
1274
- "type": "string"
1803
+ "type": "string",
1804
+ "x-lcp-pii": "internal"
1275
1805
  },
1276
1806
  "channels": {
1277
1807
  "items": {
1278
1808
  "type": "string"
1279
1809
  },
1280
1810
  "type": "array",
1281
- "uniqueItems": true
1811
+ "uniqueItems": true,
1812
+ "x-lcp-pii": "internal"
1282
1813
  },
1283
1814
  "days": {
1284
1815
  "items": {
@@ -1295,18 +1826,21 @@
1295
1826
  },
1296
1827
  "minItems": 1,
1297
1828
  "type": "array",
1298
- "uniqueItems": true
1829
+ "uniqueItems": true,
1830
+ "x-lcp-pii": "internal"
1299
1831
  },
1300
1832
  "timezone": {
1301
1833
  "minLength": 1,
1302
- "type": "string"
1834
+ "type": "string",
1835
+ "x-lcp-pii": "internal"
1303
1836
  },
1304
1837
  "verticals": {
1305
1838
  "items": {
1306
1839
  "type": "string"
1307
1840
  },
1308
1841
  "type": "array",
1309
- "uniqueItems": true
1842
+ "uniqueItems": true,
1843
+ "x-lcp-pii": "public"
1310
1844
  }
1311
1845
  },
1312
1846
  "required": [
@@ -1315,7 +1849,8 @@
1315
1849
  "available_to",
1316
1850
  "days"
1317
1851
  ],
1318
- "type": "object"
1852
+ "type": "object",
1853
+ "x-lcp-pii": "internal"
1319
1854
  }
1320
1855
  },
1321
1856
  "$id": "https://lcp.dev/schemas/offer.json",
@@ -1325,7 +1860,8 @@
1325
1860
  "properties": {
1326
1861
  "active": {
1327
1862
  "default": true,
1328
- "type": "boolean"
1863
+ "type": "boolean",
1864
+ "x-lcp-pii": "internal"
1329
1865
  },
1330
1866
  "allowed_brand_ids": {
1331
1867
  "description": "Optional publisher brand allowlist evaluated against provenance.brand_id.",
@@ -1334,7 +1870,8 @@
1334
1870
  "type": "string"
1335
1871
  },
1336
1872
  "type": "array",
1337
- "uniqueItems": true
1873
+ "uniqueItems": true,
1874
+ "x-lcp-pii": "internal"
1338
1875
  },
1339
1876
  "allowed_publisher_ids": {
1340
1877
  "description": "Optional publisher sender-ID allowlist. Matching fails closed when the incoming publisher is not listed.",
@@ -1343,12 +1880,14 @@
1343
1880
  "type": "string"
1344
1881
  },
1345
1882
  "type": "array",
1346
- "uniqueItems": true
1883
+ "uniqueItems": true,
1884
+ "x-lcp-pii": "internal"
1347
1885
  },
1348
1886
  "attribute_equals": {
1349
1887
  "additionalProperties": true,
1350
1888
  "description": "Safe declarative equality predicates keyed by vertical attribute name. Values are data, never executable expressions.",
1351
- "type": "object"
1889
+ "type": "object",
1890
+ "x-lcp-pii": "internal"
1352
1891
  },
1353
1892
  "attribute_in": {
1354
1893
  "additionalProperties": {
@@ -1356,11 +1895,13 @@
1356
1895
  "type": "array"
1357
1896
  },
1358
1897
  "description": "Safe declarative allowlists keyed by vertical attribute name.",
1359
- "type": "object"
1898
+ "type": "object",
1899
+ "x-lcp-pii": "internal"
1360
1900
  },
1361
1901
  "buyer_id": {
1362
1902
  "minLength": 1,
1363
- "type": "string"
1903
+ "type": "string",
1904
+ "x-lcp-pii": "internal"
1364
1905
  },
1365
1906
  "call_routing_mode": {
1366
1907
  "default": "post_call",
@@ -1369,7 +1910,8 @@
1369
1910
  "post_call",
1370
1911
  "realtime_transfer"
1371
1912
  ],
1372
- "type": "string"
1913
+ "type": "string",
1914
+ "x-lcp-pii": "internal"
1373
1915
  },
1374
1916
  "channels": {
1375
1917
  "items": {
@@ -1377,13 +1919,15 @@
1377
1919
  "type": "string"
1378
1920
  },
1379
1921
  "type": "array",
1380
- "uniqueItems": true
1922
+ "uniqueItems": true,
1923
+ "x-lcp-pii": "internal"
1381
1924
  },
1382
1925
  "connect_timeout_seconds": {
1383
1926
  "description": "Maximum time allowed for a real-time call transfer decision.",
1384
1927
  "maximum": 60,
1385
1928
  "minimum": 1,
1386
- "type": "integer"
1929
+ "type": "integer",
1930
+ "x-lcp-pii": "internal"
1387
1931
  },
1388
1932
  "countries": {
1389
1933
  "items": {
@@ -1392,67 +1936,79 @@
1392
1936
  },
1393
1937
  "minItems": 1,
1394
1938
  "type": "array",
1395
- "uniqueItems": true
1939
+ "uniqueItems": true,
1940
+ "x-lcp-pii": "internal"
1396
1941
  },
1397
1942
  "currency": {
1398
1943
  "pattern": "^[A-Z]{3}$",
1399
- "type": "string"
1944
+ "type": "string",
1945
+ "x-lcp-pii": "public"
1400
1946
  },
1401
1947
  "daily_cap": {
1402
1948
  "minimum": 1,
1403
- "type": "integer"
1949
+ "type": "integer",
1950
+ "x-lcp-pii": "internal"
1404
1951
  },
1405
1952
  "delivery_windows": {
1406
1953
  "items": {
1407
1954
  "$ref": "#/$defs/delivery_window"
1408
1955
  },
1409
- "type": "array"
1956
+ "type": "array",
1957
+ "x-lcp-pii": "internal"
1410
1958
  },
1411
1959
  "excluded_acquisition_methods": {
1412
1960
  "items": {
1413
1961
  "type": "string"
1414
1962
  },
1415
1963
  "type": "array",
1416
- "uniqueItems": true
1964
+ "uniqueItems": true,
1965
+ "x-lcp-pii": "internal"
1417
1966
  },
1418
1967
  "excluded_claim_language": {
1419
1968
  "items": {
1420
1969
  "type": "string"
1421
1970
  },
1422
1971
  "type": "array",
1423
- "uniqueItems": true
1972
+ "uniqueItems": true,
1973
+ "x-lcp-pii": "internal"
1424
1974
  },
1425
1975
  "excluded_incentive_types": {
1426
1976
  "items": {
1427
1977
  "type": "string"
1428
1978
  },
1429
1979
  "type": "array",
1430
- "uniqueItems": true
1980
+ "uniqueItems": true,
1981
+ "x-lcp-pii": "internal"
1431
1982
  },
1432
1983
  "excluded_source_types": {
1433
1984
  "items": {
1434
1985
  "type": "string"
1435
1986
  },
1436
1987
  "type": "array",
1437
- "uniqueItems": true
1988
+ "uniqueItems": true,
1989
+ "x-lcp-pii": "internal"
1438
1990
  },
1439
1991
  "extensions": {
1440
1992
  "additionalProperties": true,
1441
1993
  "description": "Namespaced deployment-specific criteria. Matching implementations must not execute arbitrary values as code.",
1442
- "type": "object"
1994
+ "type": "object",
1995
+ "x-lcp-pii": "internal"
1443
1996
  },
1444
1997
  "floor_price_cents": {
1445
1998
  "minimum": 0,
1446
- "type": "integer"
1999
+ "type": "integer",
2000
+ "x-lcp-pii": "internal"
1447
2001
  },
1448
2002
  "hourly_cap": {
1449
2003
  "minimum": 1,
1450
- "type": "integer"
2004
+ "type": "integer",
2005
+ "x-lcp-pii": "internal"
1451
2006
  },
1452
2007
  "max_spam_risk_score": {
1453
2008
  "maximum": 100,
1454
2009
  "minimum": 0,
1455
- "type": "integer"
2010
+ "type": "integer",
2011
+ "x-lcp-pii": "internal"
1456
2012
  },
1457
2013
  "min_data_completeness": {
1458
2014
  "enum": [
@@ -1460,17 +2016,20 @@
1460
2016
  "standard",
1461
2017
  "rich"
1462
2018
  ],
1463
- "type": "string"
2019
+ "type": "string",
2020
+ "x-lcp-pii": "internal"
1464
2021
  },
1465
2022
  "monthly_maximum_payable": {
1466
2023
  "description": "Optional hard maximum for payable outcomes in a calendar month.",
1467
2024
  "minimum": 1,
1468
- "type": "integer"
2025
+ "type": "integer",
2026
+ "x-lcp-pii": "internal"
1469
2027
  },
1470
2028
  "monthly_minimum_payable": {
1471
2029
  "description": "Operational pacing target for payable outcomes in each calendar month. It is not a guarantee of available supply.",
1472
2030
  "minimum": 0,
1473
- "type": "integer"
2031
+ "type": "integer",
2032
+ "x-lcp-pii": "internal"
1474
2033
  },
1475
2034
  "monthly_quota_policy": {
1476
2035
  "default": "monitor",
@@ -1480,19 +2039,23 @@
1480
2039
  "pace",
1481
2040
  "hard_cap"
1482
2041
  ],
1483
- "type": "string"
2042
+ "type": "string",
2043
+ "x-lcp-pii": "internal"
1484
2044
  },
1485
2045
  "monthly_quota_timezone": {
1486
2046
  "description": "IANA timezone used to determine the monthly quota period.",
1487
2047
  "minLength": 1,
1488
- "type": "string"
2048
+ "type": "string",
2049
+ "x-lcp-pii": "internal"
1489
2050
  },
1490
2051
  "offer_id": {
1491
2052
  "minLength": 1,
1492
- "type": "string"
2053
+ "type": "string",
2054
+ "x-lcp-pii": "internal"
1493
2055
  },
1494
2056
  "payable_definition": {
1495
- "type": "string"
2057
+ "type": "string",
2058
+ "x-lcp-pii": "internal"
1496
2059
  },
1497
2060
  "payable_rules": {
1498
2061
  "additionalProperties": false,
@@ -1503,15 +2066,18 @@
1503
2066
  "type": "string"
1504
2067
  },
1505
2068
  "type": "array",
1506
- "uniqueItems": true
2069
+ "uniqueItems": true,
2070
+ "x-lcp-pii": "internal"
1507
2071
  },
1508
2072
  "exclude_duplicate_resubmissions": {
1509
2073
  "default": true,
1510
- "type": "boolean"
2074
+ "type": "boolean",
2075
+ "x-lcp-pii": "internal"
1511
2076
  },
1512
2077
  "minimum_call_seconds": {
1513
2078
  "minimum": 0,
1514
- "type": "integer"
2079
+ "type": "integer",
2080
+ "x-lcp-pii": "internal"
1515
2081
  },
1516
2082
  "mode": {
1517
2083
  "default": "post_delivery",
@@ -1519,18 +2085,22 @@
1519
2085
  "post_delivery",
1520
2086
  "call_outcome"
1521
2087
  ],
1522
- "type": "string"
2088
+ "type": "string",
2089
+ "x-lcp-pii": "internal"
1523
2090
  },
1524
2091
  "require_call_answered": {
1525
- "type": "boolean"
2092
+ "type": "boolean",
2093
+ "x-lcp-pii": "internal"
1526
2094
  }
1527
2095
  },
1528
- "type": "object"
2096
+ "type": "object",
2097
+ "x-lcp-pii": "internal"
1529
2098
  },
1530
2099
  "ping_timeout_seconds": {
1531
2100
  "default": 30,
1532
2101
  "minimum": 1,
1533
- "type": "integer"
2102
+ "type": "integer",
2103
+ "x-lcp-pii": "internal"
1534
2104
  },
1535
2105
  "postal_codes": {
1536
2106
  "items": {
@@ -1538,28 +2108,36 @@
1538
2108
  "type": "string"
1539
2109
  },
1540
2110
  "type": "array",
1541
- "uniqueItems": true
2111
+ "uniqueItems": true,
2112
+ "x-lcp-pii": "internal"
1542
2113
  },
1543
2114
  "reject_blacklist_flagged": {
1544
- "type": "boolean"
2115
+ "type": "boolean",
2116
+ "x-lcp-pii": "internal"
1545
2117
  },
1546
2118
  "reject_dnc_flagged": {
1547
- "type": "boolean"
2119
+ "type": "boolean",
2120
+ "x-lcp-pii": "internal"
1548
2121
  },
1549
2122
  "reject_incentivized": {
1550
- "type": "boolean"
2123
+ "type": "boolean",
2124
+ "x-lcp-pii": "internal"
1551
2125
  },
1552
2126
  "reject_litigator_flagged": {
1553
- "type": "boolean"
2127
+ "type": "boolean",
2128
+ "x-lcp-pii": "internal"
1554
2129
  },
1555
2130
  "require_consent_evidence": {
1556
- "type": "boolean"
2131
+ "type": "boolean",
2132
+ "x-lcp-pii": "internal"
1557
2133
  },
1558
2134
  "require_verified_email": {
1559
- "type": "boolean"
2135
+ "type": "boolean",
2136
+ "x-lcp-pii": "internal"
1560
2137
  },
1561
2138
  "require_verified_phone": {
1562
- "type": "boolean"
2139
+ "type": "boolean",
2140
+ "x-lcp-pii": "internal"
1563
2141
  },
1564
2142
  "routing_mode": {
1565
2143
  "default": "auction",
@@ -1568,10 +2146,12 @@
1568
2146
  "auction",
1569
2147
  "direct"
1570
2148
  ],
1571
- "type": "string"
2149
+ "type": "string",
2150
+ "x-lcp-pii": "internal"
1572
2151
  },
1573
2152
  "schema_version": {
1574
- "type": "string"
2153
+ "type": "string",
2154
+ "x-lcp-pii": "public"
1575
2155
  },
1576
2156
  "state_regions": {
1577
2157
  "items": {
@@ -1579,20 +2159,24 @@
1579
2159
  "type": "string"
1580
2160
  },
1581
2161
  "type": "array",
1582
- "uniqueItems": true
2162
+ "uniqueItems": true,
2163
+ "x-lcp-pii": "internal"
1583
2164
  },
1584
2165
  "tenant_id": {
1585
2166
  "description": "Owning platform tenant. Deployment metadata; not necessarily exposed in public offer discovery.",
1586
2167
  "minLength": 1,
1587
- "type": "string"
2168
+ "type": "string",
2169
+ "x-lcp-pii": "internal"
1588
2170
  },
1589
2171
  "vertical": {
1590
2172
  "minLength": 1,
1591
- "type": "string"
2173
+ "type": "string",
2174
+ "x-lcp-pii": "public"
1592
2175
  },
1593
2176
  "webhook_url": {
1594
2177
  "format": "uri",
1595
- "type": "string"
2178
+ "type": "string",
2179
+ "x-lcp-pii": "restricted"
1596
2180
  }
1597
2181
  },
1598
2182
  "required": [
@@ -1616,7 +2200,8 @@
1616
2200
  "if": {
1617
2201
  "properties": {
1618
2202
  "exclusivity": {
1619
- "const": "exclusive"
2203
+ "const": "exclusive",
2204
+ "x-lcp-pii": "internal"
1620
2205
  }
1621
2206
  },
1622
2207
  "required": [
@@ -1626,7 +2211,8 @@
1626
2211
  "then": {
1627
2212
  "properties": {
1628
2213
  "slots_available": {
1629
- "const": 1
2214
+ "const": 1,
2215
+ "x-lcp-pii": "internal"
1630
2216
  }
1631
2217
  }
1632
2218
  }
@@ -1637,32 +2223,39 @@
1637
2223
  "attributes": {
1638
2224
  "additionalProperties": true,
1639
2225
  "description": "Only fields tagged ping_safe: true in the vertical schema. Banded/aggregated only \u2014 never exact values.",
1640
- "type": "object"
2226
+ "type": "object",
2227
+ "x-lcp-pii": "internal"
1641
2228
  },
1642
2229
  "compliance_flags": {
1643
2230
  "additionalProperties": true,
1644
2231
  "description": "Presence indicators only \u2014 never tokens or evidence.",
1645
2232
  "properties": {
1646
2233
  "consent": {
1647
- "type": "boolean"
2234
+ "type": "boolean",
2235
+ "x-lcp-pii": "internal"
1648
2236
  },
1649
2237
  "consent_valid": {
1650
2238
  "description": "True if consent is still within its validity window (not expired).",
1651
- "type": "boolean"
2239
+ "type": "boolean",
2240
+ "x-lcp-pii": "internal"
1652
2241
  },
1653
2242
  "dnc_checked": {
1654
- "type": "boolean"
2243
+ "type": "boolean",
2244
+ "x-lcp-pii": "internal"
1655
2245
  },
1656
2246
  "otp_verified": {
1657
- "type": "boolean"
2247
+ "type": "boolean",
2248
+ "x-lcp-pii": "internal"
1658
2249
  }
1659
2250
  },
1660
- "type": "object"
2251
+ "type": "object",
2252
+ "x-lcp-pii": "internal"
1661
2253
  },
1662
2254
  "country_code": {
1663
2255
  "description": "ISO 3166-1 alpha-2.",
1664
2256
  "pattern": "^[A-Z]{2}$",
1665
- "type": "string"
2257
+ "type": "string",
2258
+ "x-lcp-pii": "internal"
1666
2259
  },
1667
2260
  "currency": {
1668
2261
  "$ref": "core.json#/$defs/currency"
@@ -1670,12 +2263,14 @@
1670
2263
  "dedup_window_hours": {
1671
2264
  "description": "Sender hint: how many hours to dedup against. Optional.",
1672
2265
  "minimum": 1,
1673
- "type": "integer"
2266
+ "type": "integer",
2267
+ "x-lcp-pii": "internal"
1674
2268
  },
1675
2269
  "email_hash": {
1676
2270
  "description": "HMAC-SHA256(shared_secret, normalized_email) \u2014 per-pair, optional. Optional, for email-based dedup.",
1677
2271
  "pattern": "^[a-f0-9]{64}$",
1678
- "type": "string"
2272
+ "type": "string",
2273
+ "x-lcp-pii": "contact"
1679
2274
  },
1680
2275
  "exclusivity": {
1681
2276
  "description": "Hint to buyer: is this an exclusive or shared lead?",
@@ -1683,44 +2278,70 @@
1683
2278
  "exclusive",
1684
2279
  "shared"
1685
2280
  ],
1686
- "type": "string"
2281
+ "type": "string",
2282
+ "x-lcp-pii": "internal"
1687
2283
  },
1688
2284
  "expires_at": {
1689
2285
  "format": "date-time",
1690
- "type": "string"
2286
+ "type": "string",
2287
+ "x-lcp-pii": "internal"
2288
+ },
2289
+ "extensions": {
2290
+ "additionalProperties": {
2291
+ "maxProperties": 32,
2292
+ "type": "object"
2293
+ },
2294
+ "description": "v1.2: optional namespaced extension container. The receiver admits a namespace on a ping ONLY when its registration declares ping safety (governance/EXTENSION-REGISTRY.md); every other namespace is refused by name. Values are bounded objects and never carry consumer PII.",
2295
+ "maxProperties": 8,
2296
+ "propertyNames": {
2297
+ "not": {
2298
+ "pattern": "^lcp\\.core\\."
2299
+ },
2300
+ "pattern": "^[a-z0-9][a-z0-9_-]*(\\.[a-z0-9][a-z0-9_-]*){2,}$"
2301
+ },
2302
+ "type": "object",
2303
+ "x-lcp-pii": "internal"
1691
2304
  },
1692
2305
  "floor_price_cents": {
1693
2306
  "minimum": 0,
1694
- "type": "integer"
2307
+ "type": "integer",
2308
+ "x-lcp-pii": "internal"
1695
2309
  },
1696
2310
  "lead_age_minutes": {
1697
2311
  "description": "How many minutes since the consumer submitted the lead. Freshness signal for buyer pricing. Non-PII.",
1698
2312
  "minimum": 0,
1699
- "type": "integer"
2313
+ "type": "integer",
2314
+ "x-lcp-pii": "internal"
1700
2315
  },
1701
2316
  "lead_reference": {
1702
2317
  "description": "Opaque reference to the lead (not the lead_id).",
1703
- "type": "string"
2318
+ "type": "string",
2319
+ "x-lcp-pii": "internal"
1704
2320
  },
1705
2321
  "offer_id": {
1706
2322
  "description": "ID of the buyer offer this ping is being sent against. Enables audit trail for billing and disputes.",
1707
- "type": "string"
2323
+ "type": "string",
2324
+ "x-lcp-pii": "internal"
1708
2325
  },
1709
2326
  "phone_hash": {
1710
2327
  "description": "HMAC-SHA256(shared_secret, e164) \u2014 per-pair. See SPEC.md \u00a79.",
1711
2328
  "pattern": "^[a-f0-9]{64}$",
1712
- "type": "string"
2329
+ "type": "string",
2330
+ "x-lcp-pii": "contact"
1713
2331
  },
1714
2332
  "ping_id": {
1715
2333
  "description": "Unique ping identifier.",
1716
- "type": "string"
2334
+ "type": "string",
2335
+ "x-lcp-pii": "internal"
1717
2336
  },
1718
2337
  "postal_code": {
1719
- "type": "string"
2338
+ "type": "string",
2339
+ "x-lcp-pii": "internal"
1720
2340
  },
1721
2341
  "publisher_id": {
1722
2342
  "description": "ID of the publisher that generated the lead. Non-PII \u2014 buyers need this for quality tracking and routing.",
1723
- "type": "string"
2343
+ "type": "string",
2344
+ "x-lcp-pii": "internal"
1724
2345
  },
1725
2346
  "quality_flags": {
1726
2347
  "additionalProperties": true,
@@ -1728,7 +2349,8 @@
1728
2349
  "properties": {
1729
2350
  "acquisition_method": {
1730
2351
  "description": "paid_ad, organic_search, marketplace, gmb, cold_outbound, scraped, unknown. Open enum.",
1731
- "type": "string"
2352
+ "type": "string",
2353
+ "x-lcp-pii": "internal"
1732
2354
  },
1733
2355
  "blacklist_status": {
1734
2356
  "description": "Blacklist alliance scrub result.",
@@ -1738,7 +2360,8 @@
1738
2360
  "blocked",
1739
2361
  "not_checked"
1740
2362
  ],
1741
- "type": "string"
2363
+ "type": "string",
2364
+ "x-lcp-pii": "internal"
1742
2365
  },
1743
2366
  "dnc_status": {
1744
2367
  "description": "DNC scrub result.",
@@ -1748,7 +2371,8 @@
1748
2371
  "blocked",
1749
2372
  "not_checked"
1750
2373
  ],
1751
- "type": "string"
2374
+ "type": "string",
2375
+ "x-lcp-pii": "internal"
1752
2376
  },
1753
2377
  "duplicate_risk": {
1754
2378
  "enum": [
@@ -1756,15 +2380,18 @@
1756
2380
  "medium",
1757
2381
  "high"
1758
2382
  ],
1759
- "type": "string"
2383
+ "type": "string",
2384
+ "x-lcp-pii": "internal"
1760
2385
  },
1761
2386
  "incentive_type": {
1762
2387
  "description": "What incentive was offered (e.g. free_consultation, gift_card). Open enum.",
1763
- "type": "string"
2388
+ "type": "string",
2389
+ "x-lcp-pii": "internal"
1764
2390
  },
1765
2391
  "is_incentivized": {
1766
2392
  "description": "True if consumer was offered an incentive (free consultation, gift card, etc.).",
1767
- "type": "boolean"
2393
+ "type": "boolean",
2394
+ "x-lcp-pii": "internal"
1768
2395
  },
1769
2396
  "litigator_status": {
1770
2397
  "description": "Litigator scrub result.",
@@ -1774,33 +2401,41 @@
1774
2401
  "blocked",
1775
2402
  "not_checked"
1776
2403
  ],
1777
- "type": "string"
2404
+ "type": "string",
2405
+ "x-lcp-pii": "internal"
1778
2406
  },
1779
2407
  "spam_risk_score": {
1780
2408
  "maximum": 100,
1781
2409
  "minimum": 0,
1782
- "type": "integer"
2410
+ "type": "integer",
2411
+ "x-lcp-pii": "internal"
1783
2412
  },
1784
2413
  "verified_email": {
1785
- "type": "boolean"
2414
+ "type": "boolean",
2415
+ "x-lcp-pii": "internal"
1786
2416
  },
1787
2417
  "verified_phone": {
1788
- "type": "boolean"
2418
+ "type": "boolean",
2419
+ "x-lcp-pii": "internal"
1789
2420
  }
1790
2421
  },
1791
- "type": "object"
2422
+ "type": "object",
2423
+ "x-lcp-pii": "internal"
1792
2424
  },
1793
2425
  "slots_available": {
1794
2426
  "description": "v1.1 (LEP-0003): remaining buyer-award slots of this lead that can still be sold at ping time, INCLUDING the slot this ping's recipient may win. A slot counts a distinct awarded buyer, never delivered copies (SPEC.md \u00a73 slot semantics). For exclusivity 'exclusive' this MUST be 1 \u2014 the one-slot special case (enforced by the top-level conditional in this schema). Absent = the platform does not advertise slot state (v1.0 behavior). A platform MUST NOT send slots_available: 0; zero remaining means stop pinging. Non-PII integer count carrying no consumer data: it joins the ping strict allowlist as a reviewed non-PII field, and conformance keeps rejecting every other field outside the allowlist (LCP-008 PII_IN_PING protection preserved) and every attribute not tagged ping_safe: true in the vertical schema. Capability-gated (SPEC.md \u00a78): senders MUST NOT include v1.1 slot fields toward receivers whose lcp_versions advertisement does not parse to major == 1, minor >= 1.",
1795
2427
  "minimum": 1,
1796
- "type": "integer"
2428
+ "type": "integer",
2429
+ "x-lcp-pii": "internal"
1797
2430
  },
1798
2431
  "state_region": {
1799
- "type": "string"
2432
+ "type": "string",
2433
+ "x-lcp-pii": "internal"
1800
2434
  },
1801
2435
  "vertical": {
1802
2436
  "description": "Vertical identifier.",
1803
- "type": "string"
2437
+ "type": "string",
2438
+ "x-lcp-pii": "public"
1804
2439
  }
1805
2440
  },
1806
2441
  "required": [
@@ -1828,11 +2463,13 @@
1828
2463
  "$ref": "core.json#/$defs/attributes"
1829
2464
  },
1830
2465
  "buyer_id": {
1831
- "type": "string"
2466
+ "type": "string",
2467
+ "x-lcp-pii": "internal"
1832
2468
  },
1833
2469
  "buyer_reference": {
1834
2470
  "description": "Buyer's internal reference.",
1835
- "type": "string"
2471
+ "type": "string",
2472
+ "x-lcp-pii": "internal"
1836
2473
  },
1837
2474
  "call": {
1838
2475
  "additionalProperties": false,
@@ -1840,81 +2477,101 @@
1840
2477
  "properties": {
1841
2478
  "agent": {
1842
2479
  "additionalProperties": false,
1843
- "type": "object"
2480
+ "type": "object",
2481
+ "x-lcp-pii": "contact"
1844
2482
  },
1845
2483
  "call_id": {
1846
- "type": "string"
2484
+ "type": "string",
2485
+ "x-lcp-pii": "internal"
1847
2486
  },
1848
2487
  "caller_phone_hash": {
1849
2488
  "pattern": "^[a-f0-9]{64}$",
1850
- "type": "string"
2489
+ "type": "string",
2490
+ "x-lcp-pii": "contact"
1851
2491
  },
1852
2492
  "did": {
1853
- "type": "string"
2493
+ "type": "string",
2494
+ "x-lcp-pii": "internal"
1854
2495
  },
1855
2496
  "direction": {
1856
2497
  "enum": [
1857
2498
  "inbound",
1858
2499
  "outbound"
1859
2500
  ],
1860
- "type": "string"
2501
+ "type": "string",
2502
+ "x-lcp-pii": "internal"
1861
2503
  },
1862
2504
  "disposition": {
1863
- "type": "string"
2505
+ "type": "string",
2506
+ "x-lcp-pii": "internal"
1864
2507
  },
1865
2508
  "durations": {
1866
2509
  "additionalProperties": false,
1867
2510
  "properties": {
1868
2511
  "agent_seconds": {
1869
2512
  "minimum": 0,
1870
- "type": "integer"
2513
+ "type": "integer",
2514
+ "x-lcp-pii": "internal"
1871
2515
  },
1872
2516
  "hold_seconds": {
1873
2517
  "minimum": 0,
1874
- "type": "integer"
2518
+ "type": "integer",
2519
+ "x-lcp-pii": "internal"
1875
2520
  },
1876
2521
  "ivr_seconds": {
1877
2522
  "minimum": 0,
1878
- "type": "integer"
2523
+ "type": "integer",
2524
+ "x-lcp-pii": "internal"
1879
2525
  },
1880
2526
  "total_seconds": {
1881
2527
  "minimum": 0,
1882
- "type": "integer"
2528
+ "type": "integer",
2529
+ "x-lcp-pii": "internal"
1883
2530
  }
1884
2531
  },
1885
- "type": "object"
2532
+ "type": "object",
2533
+ "x-lcp-pii": "internal"
1886
2534
  },
1887
2535
  "forwarded_to": {
1888
- "type": "string"
2536
+ "type": "string",
2537
+ "x-lcp-pii": "internal"
1889
2538
  },
1890
2539
  "hangup_cause": {
1891
- "type": "string"
2540
+ "type": "string",
2541
+ "x-lcp-pii": "internal"
1892
2542
  },
1893
2543
  "ivr": {
1894
2544
  "additionalProperties": true,
1895
- "type": "object"
2545
+ "type": "object",
2546
+ "x-lcp-pii": "restricted"
1896
2547
  },
1897
2548
  "queue": {
1898
2549
  "additionalProperties": false,
1899
- "type": "object"
2550
+ "type": "object",
2551
+ "x-lcp-pii": "internal"
1900
2552
  },
1901
2553
  "recording": {
1902
2554
  "additionalProperties": true,
1903
- "type": "object"
2555
+ "type": "object",
2556
+ "x-lcp-pii": "restricted"
1904
2557
  },
1905
2558
  "started_at": {
1906
2559
  "format": "date-time",
1907
- "type": "string"
2560
+ "type": "string",
2561
+ "x-lcp-pii": "internal"
1908
2562
  },
1909
2563
  "status": {
1910
- "type": "string"
2564
+ "type": "string",
2565
+ "x-lcp-pii": "internal"
1911
2566
  },
1912
2567
  "tracking_number": {
1913
- "type": "string"
2568
+ "type": "string",
2569
+ "x-lcp-pii": "internal"
1914
2570
  },
1915
2571
  "transferred_from": {
1916
2572
  "additionalProperties": false,
1917
- "type": "object"
2573
+ "type": "object",
2574
+ "x-lcp-pii": "internal"
1918
2575
  }
1919
2576
  },
1920
2577
  "required": [
@@ -1922,7 +2579,8 @@
1922
2579
  "status",
1923
2580
  "started_at"
1924
2581
  ],
1925
- "type": "object"
2582
+ "type": "object",
2583
+ "x-lcp-pii": "restricted"
1926
2584
  },
1927
2585
  "compliance": {
1928
2586
  "$ref": "core.json#/$defs/compliance"
@@ -1938,14 +2596,16 @@
1938
2596
  "type": "string"
1939
2597
  },
1940
2598
  "maxItems": 100,
1941
- "type": "array"
2599
+ "type": "array",
2600
+ "x-lcp-pii": "contact"
1942
2601
  },
1943
2602
  "currency": {
1944
2603
  "$ref": "core.json#/$defs/currency"
1945
2604
  },
1946
2605
  "delivered_at": {
1947
2606
  "format": "date-time",
1948
- "type": "string"
2607
+ "type": "string",
2608
+ "x-lcp-pii": "internal"
1949
2609
  },
1950
2610
  "exclusivity": {
1951
2611
  "$ref": "core.json#/$defs/exclusivity"
@@ -1959,10 +2619,12 @@
1959
2619
  },
1960
2620
  "pattern": "^[a-z0-9][a-z0-9_-]*(\\.[a-z0-9][a-z0-9_-]*){2,}$"
1961
2621
  },
1962
- "type": "object"
2622
+ "type": "object",
2623
+ "x-lcp-pii": "restricted"
1963
2624
  },
1964
2625
  "lead_id": {
1965
- "type": "string"
2626
+ "type": "string",
2627
+ "x-lcp-pii": "internal"
1966
2628
  },
1967
2629
  "location": {
1968
2630
  "$ref": "core.json#/$defs/location"
@@ -1970,49 +2632,91 @@
1970
2632
  "matched_preferences": {
1971
2633
  "additionalProperties": true,
1972
2634
  "description": "Buyer preferences that matched this lead.",
1973
- "type": "object"
2635
+ "type": "object",
2636
+ "x-lcp-pii": "internal"
1974
2637
  },
1975
2638
  "offer_id": {
1976
2639
  "description": "ID of the buyer offer that matched. Audit trail for billing and disputes.",
1977
- "type": "string"
2640
+ "type": "string",
2641
+ "x-lcp-pii": "internal"
1978
2642
  },
1979
2643
  "price_cents": {
1980
2644
  "minimum": 0,
1981
- "type": "integer"
2645
+ "type": "integer",
2646
+ "x-lcp-pii": "internal"
1982
2647
  },
1983
2648
  "pricing": {
1984
2649
  "additionalProperties": false,
1985
2650
  "properties": {
2651
+ "currency": {
2652
+ "pattern": "^[A-Z]{3}$",
2653
+ "type": "string",
2654
+ "x-lcp-pii": "public"
2655
+ },
1986
2656
  "dispute_window_expires_at": {
1987
2657
  "description": "When the dispute window closes. Platforms mechanically reject disputes after this timestamp.",
1988
2658
  "format": "date-time",
1989
- "type": "string"
2659
+ "type": "string",
2660
+ "x-lcp-pii": "internal"
1990
2661
  },
1991
2662
  "dispute_window_hours": {
1992
2663
  "description": "Contractually agreed return window in hours. Buyer can dispute within this window.",
1993
2664
  "minimum": 1,
1994
- "type": "integer"
2665
+ "type": "integer",
2666
+ "x-lcp-pii": "internal"
1995
2667
  },
1996
2668
  "final_price_cents": {
1997
2669
  "minimum": 0,
1998
- "type": "integer"
2670
+ "type": "integer",
2671
+ "x-lcp-pii": "internal"
1999
2672
  },
2000
2673
  "floor_price_cents": {
2001
2674
  "minimum": 0,
2002
- "type": "integer"
2675
+ "type": "integer",
2676
+ "x-lcp-pii": "internal"
2677
+ },
2678
+ "fx_expires_at": {
2679
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
2680
+ "type": "string",
2681
+ "x-lcp-pii": "internal"
2682
+ },
2683
+ "fx_rate": {
2684
+ "description": "LEP-0010 \u00a74.1: native major units per 1 settlement major unit. Plain decimal \u2014 no sign, exponent, grouping or leading-zero integer part \u2014 with a mandatory fractional part of 6\u201312 digits, minimum six *significant* digits below 1, and a value in [0.000001, 1000000].",
2685
+ "pattern": "^(?:[1-9][0-9]*\\.[0-9]{6,12}|0\\.[0-9]*[1-9][0-9]{5,11})$",
2686
+ "type": "string",
2687
+ "x-lcp-pii": "internal"
2688
+ },
2689
+ "fx_source": {
2690
+ "maxLength": 64,
2691
+ "minLength": 1,
2692
+ "type": "string",
2693
+ "x-lcp-pii": "internal"
2694
+ },
2695
+ "fx_timestamp": {
2696
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
2697
+ "type": "string",
2698
+ "x-lcp-pii": "internal"
2003
2699
  },
2004
2700
  "is_duplicate_resub": {
2005
2701
  "description": "True if this is an accidental resubmission of a previously delivered lead.",
2006
- "type": "boolean"
2702
+ "type": "boolean",
2703
+ "x-lcp-pii": "internal"
2007
2704
  },
2008
2705
  "max_allowed_price_cents": {
2009
2706
  "minimum": 0,
2010
- "type": "integer"
2707
+ "type": "integer",
2708
+ "x-lcp-pii": "internal"
2709
+ },
2710
+ "original_price_cents": {
2711
+ "minimum": 0,
2712
+ "type": "integer",
2713
+ "x-lcp-pii": "internal"
2011
2714
  },
2012
2715
  "payable_definition": {
2013
2716
  "$comment": "Payable definition is agreed bilaterally between publisher and buyer. This field records which definition applies to this delivery.",
2014
2717
  "description": "What makes this lead payable (e.g. 'form_lead_valid_phone', 'call_answered_30s', 'connected_transfer', 'exclusive_delivery'). Open enumeration.",
2015
- "type": "string"
2718
+ "type": "string",
2719
+ "x-lcp-pii": "internal"
2016
2720
  },
2017
2721
  "payable_status": {
2018
2722
  "description": "Current payable status. 'pending' = within validation window, 'payable' = meets payable definition, 'not_payable' = failed validation, 'disputed' = under review.",
@@ -2022,21 +2726,26 @@
2022
2726
  "not_payable",
2023
2727
  "disputed"
2024
2728
  ],
2025
- "type": "string"
2729
+ "type": "string",
2730
+ "x-lcp-pii": "internal"
2026
2731
  },
2027
2732
  "premium_cents": {
2028
2733
  "minimum": 0,
2029
- "type": "integer"
2734
+ "type": "integer",
2735
+ "x-lcp-pii": "internal"
2030
2736
  },
2031
2737
  "price_guardrails": {
2032
- "type": "boolean"
2738
+ "type": "boolean",
2739
+ "x-lcp-pii": "internal"
2033
2740
  },
2034
2741
  "uncapped_price_cents": {
2035
2742
  "minimum": 0,
2036
- "type": "integer"
2743
+ "type": "integer",
2744
+ "x-lcp-pii": "internal"
2037
2745
  }
2038
2746
  },
2039
- "type": "object"
2747
+ "type": "object",
2748
+ "x-lcp-pii": "internal"
2040
2749
  },
2041
2750
  "provenance": {
2042
2751
  "$ref": "core.json#/$defs/provenance"
@@ -2044,7 +2753,8 @@
2044
2753
  "submitted_at": {
2045
2754
  "description": "When the consumer originally submitted the lead. Lets buyer assess lead age.",
2046
2755
  "format": "date-time",
2047
- "type": "string"
2756
+ "type": "string",
2757
+ "x-lcp-pii": "internal"
2048
2758
  }
2049
2759
  },
2050
2760
  "required": [
@@ -2060,6 +2770,282 @@
2060
2770
  "title": "LCP Post Message",
2061
2771
  "type": "object"
2062
2772
  },
2773
+ "schemas/quote.json": {
2774
+ "$id": "https://lcp.dev/schemas/quote.json",
2775
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
2776
+ "additionalProperties": false,
2777
+ "allOf": [
2778
+ {
2779
+ "else": {
2780
+ "required": [
2781
+ "price_cents"
2782
+ ]
2783
+ },
2784
+ "if": {
2785
+ "required": [
2786
+ "rejection_reason"
2787
+ ]
2788
+ },
2789
+ "then": {
2790
+ "not": {
2791
+ "required": [
2792
+ "price_cents"
2793
+ ]
2794
+ }
2795
+ }
2796
+ }
2797
+ ],
2798
+ "description": "Platform-opened, bounded price negotiation for a named ping (LEP-0009). Ping-class: integer minor units, ISO 4217 currency, opaque ids, timestamps, round counters, and closed/known reason values only. No consumer PII and no free text \u2014 the strict allowlist is the enforcement. Created by Spear Systems (a Spear company). Open standard \u2014 Apache 2.0, free to implement.",
2799
+ "properties": {
2800
+ "currency": {
2801
+ "$ref": "core.json#/$defs/currency"
2802
+ },
2803
+ "expires_at": {
2804
+ "description": "Absolute end of the negotiation. MUST NOT be later than the ping's expires_at (or its timestamp plus TTL).",
2805
+ "format": "date-time",
2806
+ "type": "string",
2807
+ "x-lcp-pii": "internal"
2808
+ },
2809
+ "floor_price_cents": {
2810
+ "description": "Restated from the ping so the buyer can verify the floor and the monotone rule without re-reading the ping.",
2811
+ "minimum": 0,
2812
+ "type": "integer",
2813
+ "x-lcp-pii": "internal"
2814
+ },
2815
+ "max_rounds": {
2816
+ "default": 3,
2817
+ "description": "Rounds this negotiation may run. Absent = 3 (D8 default); above the hard cap of 5 is LCP-100, never a deployment knob.",
2818
+ "maximum": 5,
2819
+ "minimum": 1,
2820
+ "type": "integer",
2821
+ "x-lcp-pii": "internal"
2822
+ },
2823
+ "negotiation_id": {
2824
+ "description": "Opaque platform-assigned negotiation id, unique per negotiation. The only lookup key a later message may use.",
2825
+ "pattern": "^neg_[A-Za-z0-9_-]{8,64}$",
2826
+ "type": "string",
2827
+ "x-lcp-pii": "internal"
2828
+ },
2829
+ "offer_id": {
2830
+ "description": "The buyer offer being priced; MUST equal the ping's offer_id (LCP-100 on mismatch).",
2831
+ "minLength": 1,
2832
+ "type": "string",
2833
+ "x-lcp-pii": "internal"
2834
+ },
2835
+ "ping_id": {
2836
+ "description": "The ping this negotiation prices. Supplies the floor, currency, and the TTL ceiling.",
2837
+ "minLength": 1,
2838
+ "type": "string",
2839
+ "x-lcp-pii": "internal"
2840
+ },
2841
+ "price_cents": {
2842
+ "description": "The ask in minor units of currency. MUST be at or above floor_price_cents; below floor is refused below_floor_price and never clamped.",
2843
+ "minimum": 0,
2844
+ "type": "integer",
2845
+ "x-lcp-pii": "internal"
2846
+ },
2847
+ "rejection_reason": {
2848
+ "description": "Open enumeration. Present only on a terminal refusal message (no negotiation opened): below_floor_price, round_limit_exceeded, negotiation_expired, unknown_negotiation, negotiation_closed. When present, price_cents MUST be absent.",
2849
+ "minLength": 1,
2850
+ "type": "string",
2851
+ "x-lcp-pii": "internal"
2852
+ },
2853
+ "rounds_remaining": {
2854
+ "description": "Buyer counters still available at the moment this message is sent. On the opening quote this equals the effective max_rounds (a quote consumes no round).",
2855
+ "maximum": 5,
2856
+ "minimum": 0,
2857
+ "type": "integer",
2858
+ "x-lcp-pii": "internal"
2859
+ }
2860
+ },
2861
+ "required": [
2862
+ "negotiation_id",
2863
+ "ping_id",
2864
+ "offer_id",
2865
+ "currency",
2866
+ "floor_price_cents",
2867
+ "rounds_remaining",
2868
+ "expires_at"
2869
+ ],
2870
+ "title": "LCP Quote Message",
2871
+ "type": "object"
2872
+ },
2873
+ "schemas/subscription.json": {
2874
+ "$id": "https://lcp.dev/schemas/subscription.json",
2875
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
2876
+ "additionalProperties": false,
2877
+ "description": "v1.2 (LEP-0001 W3): event-subscription registration and its resource view. The payload is a strict object: an explicit event allowlist drawn from the receiver's advertised `capabilities().events`, an HTTPS callback URL, and a filter whose keys are a closed set of core enums and identifiers. Consumer, provenance, attributes, details, contact, and security paths are never filter keys. The registration response carries `subscription_id`, `active`, `created_at`, and the per-subscription `secret` exactly once. Created by Spear Systems (a Spear company). Open standard \u2014 Apache 2.0, free to implement.",
2878
+ "properties": {
2879
+ "active": {
2880
+ "description": "Subscription state. A disabled subscription receives no new deliveries.",
2881
+ "type": "boolean",
2882
+ "x-lcp-pii": "internal"
2883
+ },
2884
+ "callback_url": {
2885
+ "description": "HTTPS callback destination (http only in an explicitly configured sandbox). Validated with the conformance runner's SSRF rule: no embedded credentials, a valid port, and only public resolved addresses.",
2886
+ "maxLength": 2048,
2887
+ "pattern": "^https?://",
2888
+ "type": "string",
2889
+ "x-lcp-pii": "internal"
2890
+ },
2891
+ "created_at": {
2892
+ "description": "Registration time in whole-second UTC form.",
2893
+ "format": "date-time",
2894
+ "type": "string",
2895
+ "x-lcp-pii": "internal"
2896
+ },
2897
+ "event_types": {
2898
+ "description": "Explicit event allowlist. Values are the receiver's advertised event names; no wildcard and no second vocabulary exist. An unadvertised value is refused, never silently ignored.",
2899
+ "items": {
2900
+ "enum": [
2901
+ "DELIVERED",
2902
+ "ACCEPTED",
2903
+ "REJECTED",
2904
+ "DISPUTED",
2905
+ "REFUNDED",
2906
+ "EXPIRED",
2907
+ "CONVERTED",
2908
+ "ARCHIVED",
2909
+ "CALL_OFFERED",
2910
+ "CALL_CONNECTED",
2911
+ "CALL_ENDED",
2912
+ "CALL_OUTCOME",
2913
+ "CONTACTED",
2914
+ "FINAL_PRICING"
2915
+ ],
2916
+ "type": "string",
2917
+ "x-lcp-pii": "internal"
2918
+ },
2919
+ "maxItems": 14,
2920
+ "minItems": 1,
2921
+ "type": "array",
2922
+ "uniqueItems": true,
2923
+ "x-lcp-pii": "internal"
2924
+ },
2925
+ "filter": {
2926
+ "additionalProperties": false,
2927
+ "description": "Closed filter over core enums and identifiers. Any other key, including consumer.email, provenance.*, and attributes.*, is refused with a named error.",
2928
+ "properties": {
2929
+ "event_type": {
2930
+ "oneOf": [
2931
+ {
2932
+ "minLength": 1,
2933
+ "type": "string"
2934
+ },
2935
+ {
2936
+ "items": {
2937
+ "minLength": 1,
2938
+ "type": "string"
2939
+ },
2940
+ "minItems": 1,
2941
+ "type": "array",
2942
+ "uniqueItems": true
2943
+ }
2944
+ ],
2945
+ "x-lcp-pii": "internal"
2946
+ },
2947
+ "lead_id": {
2948
+ "oneOf": [
2949
+ {
2950
+ "minLength": 1,
2951
+ "type": "string"
2952
+ },
2953
+ {
2954
+ "items": {
2955
+ "minLength": 1,
2956
+ "type": "string"
2957
+ },
2958
+ "minItems": 1,
2959
+ "type": "array",
2960
+ "uniqueItems": true
2961
+ }
2962
+ ],
2963
+ "x-lcp-pii": "internal"
2964
+ },
2965
+ "message_type": {
2966
+ "oneOf": [
2967
+ {
2968
+ "minLength": 1,
2969
+ "type": "string"
2970
+ },
2971
+ {
2972
+ "items": {
2973
+ "minLength": 1,
2974
+ "type": "string"
2975
+ },
2976
+ "minItems": 1,
2977
+ "type": "array",
2978
+ "uniqueItems": true
2979
+ }
2980
+ ],
2981
+ "x-lcp-pii": "internal"
2982
+ },
2983
+ "status": {
2984
+ "oneOf": [
2985
+ {
2986
+ "minLength": 1,
2987
+ "type": "string"
2988
+ },
2989
+ {
2990
+ "items": {
2991
+ "minLength": 1,
2992
+ "type": "string"
2993
+ },
2994
+ "minItems": 1,
2995
+ "type": "array",
2996
+ "uniqueItems": true
2997
+ }
2998
+ ],
2999
+ "x-lcp-pii": "internal"
3000
+ },
3001
+ "vertical": {
3002
+ "oneOf": [
3003
+ {
3004
+ "minLength": 1,
3005
+ "type": "string"
3006
+ },
3007
+ {
3008
+ "items": {
3009
+ "minLength": 1,
3010
+ "type": "string"
3011
+ },
3012
+ "minItems": 1,
3013
+ "type": "array",
3014
+ "uniqueItems": true
3015
+ }
3016
+ ],
3017
+ "x-lcp-pii": "internal"
3018
+ }
3019
+ },
3020
+ "type": "object",
3021
+ "x-lcp-pii": "internal"
3022
+ },
3023
+ "replay_from": {
3024
+ "description": "Opaque cursor from GET /v1/lcp/events. A subscription created with it replays that event set deterministically; an expired cursor is an explicit error.",
3025
+ "minLength": 1,
3026
+ "type": "string",
3027
+ "x-lcp-pii": "internal"
3028
+ },
3029
+ "secret": {
3030
+ "description": "Per-subscription HMAC secret. Returned exactly once on registration and never again; deliveries are signed with it over the LEP-0002 canonical input.",
3031
+ "minLength": 32,
3032
+ "type": "string",
3033
+ "x-lcp-pii": "restricted"
3034
+ },
3035
+ "subscription_id": {
3036
+ "description": "Opaque subscription identifier returned on registration. It is not a bearer credential: every read, disable, and delivery is authorized against the subscriber's tenant.",
3037
+ "pattern": "^sub_[A-Za-z0-9_-]{8,64}$",
3038
+ "type": "string",
3039
+ "x-lcp-pii": "internal"
3040
+ }
3041
+ },
3042
+ "required": [
3043
+ "event_types",
3044
+ "callback_url"
3045
+ ],
3046
+ "title": "LCP Subscription Message",
3047
+ "type": "object"
3048
+ },
2063
3049
  "verticals/home_services.json": {
2064
3050
  "$id": "https://lcp.dev/verticals/home_services.json",
2065
3051
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -2077,7 +3063,8 @@
2077
3063
  "unknown"
2078
3064
  ],
2079
3065
  "ping_safe": true,
2080
- "type": "string"
3066
+ "type": "string",
3067
+ "x-lcp-pii": "public"
2081
3068
  },
2082
3069
  "damage_type": {
2083
3070
  "enum": [
@@ -2092,26 +3079,31 @@
2092
3079
  "none"
2093
3080
  ],
2094
3081
  "ping_safe": true,
2095
- "type": "string"
3082
+ "type": "string",
3083
+ "x-lcp-pii": "public"
2096
3084
  },
2097
3085
  "exact_budget": {
2098
3086
  "description": "Exact budget is post-only; use budget_band in a ping.",
2099
3087
  "minimum": 0,
2100
3088
  "ping_safe": false,
2101
- "type": "number"
3089
+ "type": "number",
3090
+ "x-lcp-pii": "restricted"
2102
3091
  },
2103
3092
  "free_text": {
2104
3093
  "description": "Free text is post-only because it may contain names, addresses, or sensitive details.",
2105
3094
  "ping_safe": false,
2106
- "type": "string"
3095
+ "type": "string",
3096
+ "x-lcp-pii": "restricted"
2107
3097
  },
2108
3098
  "has_existing_damage": {
2109
3099
  "ping_safe": true,
2110
- "type": "boolean"
3100
+ "type": "boolean",
3101
+ "x-lcp-pii": "public"
2111
3102
  },
2112
3103
  "has_insurance_claim": {
2113
3104
  "ping_safe": true,
2114
- "type": "boolean"
3105
+ "type": "boolean",
3106
+ "x-lcp-pii": "public"
2115
3107
  },
2116
3108
  "material": {
2117
3109
  "enum": [
@@ -2128,7 +3120,8 @@
2128
3120
  "unknown"
2129
3121
  ],
2130
3122
  "ping_safe": true,
2131
- "type": "string"
3123
+ "type": "string",
3124
+ "x-lcp-pii": "public"
2132
3125
  },
2133
3126
  "number_of_rooms_band": {
2134
3127
  "enum": [
@@ -2140,7 +3133,8 @@
2140
3133
  "unknown"
2141
3134
  ],
2142
3135
  "ping_safe": true,
2143
- "type": "string"
3136
+ "type": "string",
3137
+ "x-lcp-pii": "public"
2144
3138
  },
2145
3139
  "occupancy": {
2146
3140
  "enum": [
@@ -2151,7 +3145,8 @@
2151
3145
  "unknown"
2152
3146
  ],
2153
3147
  "ping_safe": true,
2154
- "type": "string"
3148
+ "type": "string",
3149
+ "x-lcp-pii": "public"
2155
3150
  },
2156
3151
  "preferred_schedule": {
2157
3152
  "enum": [
@@ -2162,7 +3157,8 @@
2162
3157
  "specific_date"
2163
3158
  ],
2164
3159
  "ping_safe": true,
2165
- "type": "string"
3160
+ "type": "string",
3161
+ "x-lcp-pii": "public"
2166
3162
  },
2167
3163
  "project_type": {
2168
3164
  "description": "Legacy-compatible project classification.",
@@ -2177,7 +3173,8 @@
2177
3173
  "other"
2178
3174
  ],
2179
3175
  "ping_safe": true,
2180
- "type": "string"
3176
+ "type": "string",
3177
+ "x-lcp-pii": "public"
2181
3178
  },
2182
3179
  "property_age_band": {
2183
3180
  "enum": [
@@ -2189,7 +3186,8 @@
2189
3186
  "unknown"
2190
3187
  ],
2191
3188
  "ping_safe": true,
2192
- "type": "string"
3189
+ "type": "string",
3190
+ "x-lcp-pii": "public"
2193
3191
  },
2194
3192
  "property_type": {
2195
3193
  "enum": [
@@ -2201,7 +3199,8 @@
2201
3199
  "other"
2202
3200
  ],
2203
3201
  "ping_safe": true,
2204
- "type": "string"
3202
+ "type": "string",
3203
+ "x-lcp-pii": "public"
2205
3204
  },
2206
3205
  "roof_type": {
2207
3206
  "enum": [
@@ -2214,11 +3213,13 @@
2214
3213
  "unknown"
2215
3214
  ],
2216
3215
  "ping_safe": true,
2217
- "type": "string"
3216
+ "type": "string",
3217
+ "x-lcp-pii": "public"
2218
3218
  },
2219
3219
  "schema_version": {
2220
3220
  "const": "1.0.0",
2221
- "type": "string"
3221
+ "type": "string",
3222
+ "x-lcp-pii": "public"
2222
3223
  },
2223
3224
  "service_subtype": {
2224
3225
  "description": "Controlled service operation. A more specific taxonomy can be introduced by a future vertical schema version without changing the core.",
@@ -2235,7 +3236,8 @@
2235
3236
  "other"
2236
3237
  ],
2237
3238
  "ping_safe": true,
2238
- "type": "string"
3239
+ "type": "string",
3240
+ "x-lcp-pii": "public"
2239
3241
  },
2240
3242
  "service_type": {
2241
3243
  "description": "Controlled top-level service category.",
@@ -2262,7 +3264,8 @@
2262
3264
  "other"
2263
3265
  ],
2264
3266
  "ping_safe": true,
2265
- "type": "string"
3267
+ "type": "string",
3268
+ "x-lcp-pii": "public"
2266
3269
  },
2267
3270
  "square_footage_band": {
2268
3271
  "enum": [
@@ -2275,7 +3278,8 @@
2275
3278
  "unknown"
2276
3279
  ],
2277
3280
  "ping_safe": true,
2278
- "type": "string"
3281
+ "type": "string",
3282
+ "x-lcp-pii": "public"
2279
3283
  },
2280
3284
  "stories_band": {
2281
3285
  "enum": [
@@ -2285,7 +3289,8 @@
2285
3289
  "unknown"
2286
3290
  ],
2287
3291
  "ping_safe": true,
2288
- "type": "string"
3292
+ "type": "string",
3293
+ "x-lcp-pii": "public"
2289
3294
  },
2290
3295
  "urgency": {
2291
3296
  "enum": [
@@ -2295,11 +3300,13 @@
2295
3300
  "flexible"
2296
3301
  ],
2297
3302
  "ping_safe": true,
2298
- "type": "string"
3303
+ "type": "string",
3304
+ "x-lcp-pii": "public"
2299
3305
  },
2300
3306
  "vertical": {
2301
3307
  "const": "home_services",
2302
- "type": "string"
3308
+ "type": "string",
3309
+ "x-lcp-pii": "public"
2303
3310
  }
2304
3311
  },
2305
3312
  "required": [
@@ -2324,7 +3331,8 @@
2324
3331
  "three_or_more"
2325
3332
  ],
2326
3333
  "ping_safe": false,
2327
- "type": "string"
3334
+ "type": "string",
3335
+ "x-lcp-pii": "restricted"
2328
3336
  },
2329
3337
  "coverage_amount_band": {
2330
3338
  "description": "Banded coverage amount for ping use.",
@@ -2338,7 +3346,8 @@
2338
3346
  "over_1m"
2339
3347
  ],
2340
3348
  "ping_safe": true,
2341
- "type": "string"
3349
+ "type": "string",
3350
+ "x-lcp-pii": "public"
2342
3351
  },
2343
3352
  "coverage_type": {
2344
3353
  "description": "Type of coverage sought.",
@@ -2357,12 +3366,14 @@
2357
3366
  "other"
2358
3367
  ],
2359
3368
  "ping_safe": true,
2360
- "type": "string"
3369
+ "type": "string",
3370
+ "x-lcp-pii": "public"
2361
3371
  },
2362
3372
  "current_insurer": {
2363
3373
  "description": "Current insurance company name. Company name \u2014 not ping_safe.",
2364
3374
  "ping_safe": false,
2365
- "type": "string"
3375
+ "type": "string",
3376
+ "x-lcp-pii": "internal"
2366
3377
  },
2367
3378
  "deductible_band": {
2368
3379
  "description": "Banded deductible amount for ping use.",
@@ -2375,7 +3386,8 @@
2375
3386
  "over_5000"
2376
3387
  ],
2377
3388
  "ping_safe": true,
2378
- "type": "string"
3389
+ "type": "string",
3390
+ "x-lcp-pii": "public"
2379
3391
  },
2380
3392
  "driver_age_band": {
2381
3393
  "description": "Banded driver age. Ping_safe for auto insurance underwriting.",
@@ -2389,7 +3401,8 @@
2389
3401
  "over_65"
2390
3402
  ],
2391
3403
  "ping_safe": true,
2392
- "type": "string"
3404
+ "type": "string",
3405
+ "x-lcp-pii": "public"
2393
3406
  },
2394
3407
  "gender": {
2395
3408
  "description": "Gender \u2014 sensitive underwriting data; post-only.",
@@ -2400,12 +3413,14 @@
2400
3413
  "prefer_not_to_say"
2401
3414
  ],
2402
3415
  "ping_safe": false,
2403
- "type": "string"
3416
+ "type": "string",
3417
+ "x-lcp-pii": "restricted"
2404
3418
  },
2405
3419
  "has_claims_history": {
2406
3420
  "description": "Has the consumer filed any claims? Sensitive underwriting data; post-only.",
2407
3421
  "ping_safe": false,
2408
- "type": "boolean"
3422
+ "type": "boolean",
3423
+ "x-lcp-pii": "restricted"
2409
3424
  },
2410
3425
  "health_condition_band": {
2411
3426
  "description": "Self-reported health condition band for health insurance; sensitive health data, post-only.",
@@ -2417,7 +3432,8 @@
2417
3432
  "unknown"
2418
3433
  ],
2419
3434
  "ping_safe": false,
2420
- "type": "string"
3435
+ "type": "string",
3436
+ "x-lcp-pii": "restricted"
2421
3437
  },
2422
3438
  "height_band": {
2423
3439
  "description": "Banded height for health/life insurance underwriting; sensitive health data, post-only.",
@@ -2429,7 +3445,8 @@
2429
3445
  "over_6ft"
2430
3446
  ],
2431
3447
  "ping_safe": false,
2432
- "type": "string"
3448
+ "type": "string",
3449
+ "x-lcp-pii": "restricted"
2433
3450
  },
2434
3451
  "insurance_type": {
2435
3452
  "enum": [
@@ -2440,7 +3457,8 @@
2440
3457
  "business"
2441
3458
  ],
2442
3459
  "ping_safe": true,
2443
- "type": "string"
3460
+ "type": "string",
3461
+ "x-lcp-pii": "public"
2444
3462
  },
2445
3463
  "marital_status": {
2446
3464
  "enum": [
@@ -2452,7 +3470,8 @@
2452
3470
  "domestic_partnership"
2453
3471
  ],
2454
3472
  "ping_safe": false,
2455
- "type": "string"
3473
+ "type": "string",
3474
+ "x-lcp-pii": "restricted"
2456
3475
  },
2457
3476
  "occupation_class": {
2458
3477
  "description": "Occupation risk class for life/disability insurance underwriting; sensitive employment data, post-only.",
@@ -2466,7 +3485,8 @@
2466
3485
  "other"
2467
3486
  ],
2468
3487
  "ping_safe": false,
2469
- "type": "string"
3488
+ "type": "string",
3489
+ "x-lcp-pii": "restricted"
2470
3490
  },
2471
3491
  "property_type": {
2472
3492
  "description": "Property type for home insurance.",
@@ -2480,16 +3500,19 @@
2480
3500
  "other"
2481
3501
  ],
2482
3502
  "ping_safe": true,
2483
- "type": "string"
3503
+ "type": "string",
3504
+ "x-lcp-pii": "public"
2484
3505
  },
2485
3506
  "schema_version": {
2486
3507
  "const": "1.0.0",
2487
- "type": "string"
3508
+ "type": "string",
3509
+ "x-lcp-pii": "public"
2488
3510
  },
2489
3511
  "smoker": {
2490
3512
  "description": "Smoking status for health/life insurance underwriting; sensitive health data, post-only.",
2491
3513
  "ping_safe": false,
2492
- "type": "boolean"
3514
+ "type": "boolean",
3515
+ "x-lcp-pii": "restricted"
2493
3516
  },
2494
3517
  "vehicle_type": {
2495
3518
  "description": "Vehicle type for auto insurance. Ping_safe for auto.",
@@ -2505,11 +3528,13 @@
2505
3528
  "other"
2506
3529
  ],
2507
3530
  "ping_safe": true,
2508
- "type": "string"
3531
+ "type": "string",
3532
+ "x-lcp-pii": "public"
2509
3533
  },
2510
3534
  "vertical": {
2511
3535
  "const": "insurance",
2512
- "type": "string"
3536
+ "type": "string",
3537
+ "x-lcp-pii": "public"
2513
3538
  },
2514
3539
  "weight_band": {
2515
3540
  "description": "Banded weight (lbs) for health/life insurance underwriting; sensitive health data, post-only.",
@@ -2522,7 +3547,8 @@
2522
3547
  "over_250"
2523
3548
  ],
2524
3549
  "ping_safe": false,
2525
- "type": "string"
3550
+ "type": "string",
3551
+ "x-lcp-pii": "restricted"
2526
3552
  },
2527
3553
  "years_with_current_insurer_band": {
2528
3554
  "description": "Banded years with current insurer.",
@@ -2534,7 +3560,8 @@
2534
3560
  "over_10"
2535
3561
  ],
2536
3562
  "ping_safe": true,
2537
- "type": "string"
3563
+ "type": "string",
3564
+ "x-lcp-pii": "public"
2538
3565
  }
2539
3566
  },
2540
3567
  "required": [
@@ -2553,7 +3580,8 @@
2553
3580
  "at_fault": {
2554
3581
  "description": "Was the consumer at fault? Sensitive legal liability data; post-only.",
2555
3582
  "ping_safe": false,
2556
- "type": "boolean"
3583
+ "type": "boolean",
3584
+ "x-lcp-pii": "restricted"
2557
3585
  },
2558
3586
  "case_type": {
2559
3587
  "enum": [
@@ -2567,7 +3595,8 @@
2567
3595
  "medical_malpractice"
2568
3596
  ],
2569
3597
  "ping_safe": true,
2570
- "type": "string"
3598
+ "type": "string",
3599
+ "x-lcp-pii": "public"
2571
3600
  },
2572
3601
  "claim_status": {
2573
3602
  "description": "Current status of the claim; sensitive legal data, post-only.",
@@ -2580,23 +3609,27 @@
2580
3609
  "in_litigation"
2581
3610
  ],
2582
3611
  "ping_safe": false,
2583
- "type": "string"
3612
+ "type": "string",
3613
+ "x-lcp-pii": "restricted"
2584
3614
  },
2585
3615
  "has_attorney": {
2586
3616
  "description": "Does the consumer already have an attorney? Legal-representation data; post-only.",
2587
3617
  "ping_safe": false,
2588
- "type": "boolean"
3618
+ "type": "boolean",
3619
+ "x-lcp-pii": "restricted"
2589
3620
  },
2590
3621
  "incident_date": {
2591
3622
  "description": "Date of incident. Not ping_safe \u2014 could narrow identity.",
2592
3623
  "format": "date",
2593
3624
  "ping_safe": false,
2594
- "type": "string"
3625
+ "type": "string",
3626
+ "x-lcp-pii": "restricted"
2595
3627
  },
2596
3628
  "incident_state": {
2597
3629
  "description": "US state where incident occurred.",
2598
3630
  "ping_safe": true,
2599
- "type": "string"
3631
+ "type": "string",
3632
+ "x-lcp-pii": "internal"
2600
3633
  },
2601
3634
  "injury_severity": {
2602
3635
  "description": "Severity of injury sustained; sensitive health/legal data, post-only.",
@@ -2609,37 +3642,44 @@
2609
3642
  "fatal"
2610
3643
  ],
2611
3644
  "ping_safe": false,
2612
- "type": "string"
3645
+ "type": "string",
3646
+ "x-lcp-pii": "restricted"
2613
3647
  },
2614
3648
  "insurance_company": {
2615
3649
  "description": "Insurance company involved. Company name \u2014 not ping_safe.",
2616
3650
  "ping_safe": false,
2617
- "type": "string"
3651
+ "type": "string",
3652
+ "x-lcp-pii": "internal"
2618
3653
  },
2619
3654
  "medical_treatment_received": {
2620
3655
  "description": "Has medical treatment been received? Sensitive health/legal data; post-only.",
2621
3656
  "ping_safe": false,
2622
- "type": "boolean"
3657
+ "type": "boolean",
3658
+ "x-lcp-pii": "restricted"
2623
3659
  },
2624
3660
  "police_report_filed": {
2625
3661
  "description": "Was a police report filed? Sensitive incident data; post-only.",
2626
3662
  "ping_safe": false,
2627
- "type": "boolean"
3663
+ "type": "boolean",
3664
+ "x-lcp-pii": "restricted"
2628
3665
  },
2629
3666
  "schema_version": {
2630
3667
  "const": "1.0.0",
2631
- "type": "string"
3668
+ "type": "string",
3669
+ "x-lcp-pii": "public"
2632
3670
  },
2633
3671
  "time_to_contact_deadline_days": {
2634
3672
  "description": "Days remaining to contact before statute of limitations or deadline; sensitive legal timing, post-only.",
2635
3673
  "maximum": 3650,
2636
3674
  "minimum": 0,
2637
3675
  "ping_safe": false,
2638
- "type": "integer"
3676
+ "type": "integer",
3677
+ "x-lcp-pii": "internal"
2639
3678
  },
2640
3679
  "vertical": {
2641
3680
  "const": "legal",
2642
- "type": "string"
3681
+ "type": "string",
3682
+ "x-lcp-pii": "public"
2643
3683
  }
2644
3684
  },
2645
3685
  "required": [
@@ -2665,18 +3705,21 @@
2665
3705
  "over_150k"
2666
3706
  ],
2667
3707
  "ping_safe": true,
2668
- "type": "string"
3708
+ "type": "string",
3709
+ "x-lcp-pii": "public"
2669
3710
  },
2670
3711
  "annual_income_cents": {
2671
3712
  "description": "Annual income. PII-adjacent \u2014 not ping_safe.",
2672
3713
  "minimum": 0,
2673
3714
  "ping_safe": false,
2674
- "type": "integer"
3715
+ "type": "integer",
3716
+ "x-lcp-pii": "restricted"
2675
3717
  },
2676
3718
  "bankruptcy_history": {
2677
3719
  "description": "Has the consumer filed for bankruptcy? Sensitive financial data; post-only.",
2678
3720
  "ping_safe": false,
2679
- "type": "boolean"
3721
+ "type": "boolean",
3722
+ "x-lcp-pii": "restricted"
2680
3723
  },
2681
3724
  "cash_out_amount_band": {
2682
3725
  "enum": [
@@ -2687,13 +3730,15 @@
2687
3730
  "over_100k"
2688
3731
  ],
2689
3732
  "ping_safe": true,
2690
- "type": "string"
3733
+ "type": "string",
3734
+ "x-lcp-pii": "public"
2691
3735
  },
2692
3736
  "cash_out_amount_cents": {
2693
3737
  "description": "Cash-out amount for cash-out refinance. Not ping_safe.",
2694
3738
  "minimum": 0,
2695
3739
  "ping_safe": false,
2696
- "type": "integer"
3740
+ "type": "integer",
3741
+ "x-lcp-pii": "restricted"
2697
3742
  },
2698
3743
  "credit_rating_band": {
2699
3744
  "description": "Credit classification is sensitive financial data; post-only.",
@@ -2705,12 +3750,14 @@
2705
3750
  "unknown"
2706
3751
  ],
2707
3752
  "ping_safe": false,
2708
- "type": "string"
3753
+ "type": "string",
3754
+ "x-lcp-pii": "restricted"
2709
3755
  },
2710
3756
  "current_lender": {
2711
3757
  "description": "Current mortgage lender (refinance context). Company name \u2014 not ping_safe.",
2712
3758
  "ping_safe": false,
2713
- "type": "string"
3759
+ "type": "string",
3760
+ "x-lcp-pii": "internal"
2714
3761
  },
2715
3762
  "desired_rate_term": {
2716
3763
  "description": "Desired mortgage rate term.",
@@ -2725,7 +3772,8 @@
2725
3772
  "other"
2726
3773
  ],
2727
3774
  "ping_safe": true,
2728
- "type": "string"
3775
+ "type": "string",
3776
+ "x-lcp-pii": "public"
2729
3777
  },
2730
3778
  "employment_status": {
2731
3779
  "enum": [
@@ -2736,27 +3784,32 @@
2736
3784
  "student"
2737
3785
  ],
2738
3786
  "ping_safe": true,
2739
- "type": "string"
3787
+ "type": "string",
3788
+ "x-lcp-pii": "public"
2740
3789
  },
2741
3790
  "existing_rate_percent": {
2742
3791
  "description": "Current interest rate. Not ping_safe \u2014 can narrow identity.",
2743
3792
  "maximum": 30,
2744
3793
  "minimum": 0,
2745
3794
  "ping_safe": false,
2746
- "type": "number"
3795
+ "type": "number",
3796
+ "x-lcp-pii": "restricted"
2747
3797
  },
2748
3798
  "foreclosure_history": {
2749
3799
  "description": "Has the consumer had a foreclosure? Sensitive financial data; post-only.",
2750
3800
  "ping_safe": false,
2751
- "type": "boolean"
3801
+ "type": "boolean",
3802
+ "x-lcp-pii": "restricted"
2752
3803
  },
2753
3804
  "has_existing_mortgage": {
2754
3805
  "ping_safe": true,
2755
- "type": "boolean"
3806
+ "type": "boolean",
3807
+ "x-lcp-pii": "public"
2756
3808
  },
2757
3809
  "is_first_home_buyer": {
2758
3810
  "ping_safe": true,
2759
- "type": "boolean"
3811
+ "type": "boolean",
3812
+ "x-lcp-pii": "public"
2760
3813
  },
2761
3814
  "loan_amount_band": {
2762
3815
  "description": "Banded loan amount for ping use.",
@@ -2769,13 +3822,15 @@
2769
3822
  "over_1m"
2770
3823
  ],
2771
3824
  "ping_safe": true,
2772
- "type": "string"
3825
+ "type": "string",
3826
+ "x-lcp-pii": "public"
2773
3827
  },
2774
3828
  "loan_amount_cents": {
2775
3829
  "description": "Exact loan amount in cents. PII-adjacent \u2014 not ping_safe.",
2776
3830
  "minimum": 0,
2777
3831
  "ping_safe": false,
2778
- "type": "integer"
3832
+ "type": "integer",
3833
+ "x-lcp-pii": "restricted"
2779
3834
  },
2780
3835
  "loan_term_band": {
2781
3836
  "description": "Banded loan term.",
@@ -2787,14 +3842,16 @@
2787
3842
  "over_30"
2788
3843
  ],
2789
3844
  "ping_safe": true,
2790
- "type": "string"
3845
+ "type": "string",
3846
+ "x-lcp-pii": "public"
2791
3847
  },
2792
3848
  "loan_term_years": {
2793
3849
  "description": "Exact loan term in years. Not ping_safe.",
2794
3850
  "maximum": 40,
2795
3851
  "minimum": 1,
2796
3852
  "ping_safe": false,
2797
- "type": "integer"
3853
+ "type": "integer",
3854
+ "x-lcp-pii": "restricted"
2798
3855
  },
2799
3856
  "loan_type": {
2800
3857
  "enum": [
@@ -2806,7 +3863,8 @@
2806
3863
  "investment"
2807
3864
  ],
2808
3865
  "ping_safe": true,
2809
- "type": "string"
3866
+ "type": "string",
3867
+ "x-lcp-pii": "public"
2810
3868
  },
2811
3869
  "ltv_ratio_band": {
2812
3870
  "description": "Loan-to-value ratio band.",
@@ -2819,7 +3877,8 @@
2819
3877
  "over_95"
2820
3878
  ],
2821
3879
  "ping_safe": true,
2822
- "type": "string"
3880
+ "type": "string",
3881
+ "x-lcp-pii": "public"
2823
3882
  },
2824
3883
  "mortgage_product": {
2825
3884
  "additionalProperties": false,
@@ -2838,7 +3897,8 @@
2838
3897
  "type": [
2839
3898
  "string",
2840
3899
  "null"
2841
- ]
3900
+ ],
3901
+ "x-lcp-pii": "public"
2842
3902
  },
2843
3903
  "ca_product": {
2844
3904
  "description": "Canadian mortgage product type. Null if not CA.",
@@ -2852,12 +3912,14 @@
2852
3912
  "type": [
2853
3913
  "string",
2854
3914
  "null"
2855
- ]
3915
+ ],
3916
+ "x-lcp-pii": "public"
2856
3917
  },
2857
3918
  "country_code": {
2858
3919
  "description": "ISO 3166-1 alpha-2 country code (e.g. US, CA, GB, AU).",
2859
3920
  "ping_safe": true,
2860
- "type": "string"
3921
+ "type": "string",
3922
+ "x-lcp-pii": "internal"
2861
3923
  },
2862
3924
  "gb_product": {
2863
3925
  "description": "UK mortgage product type. Null if not GB.",
@@ -2872,7 +3934,8 @@
2872
3934
  "type": [
2873
3935
  "string",
2874
3936
  "null"
2875
- ]
3937
+ ],
3938
+ "x-lcp-pii": "public"
2876
3939
  },
2877
3940
  "us_product": {
2878
3941
  "description": "US mortgage product type. Null if not US.",
@@ -2889,13 +3952,15 @@
2889
3952
  "type": [
2890
3953
  "string",
2891
3954
  "null"
2892
- ]
3955
+ ],
3956
+ "x-lcp-pii": "public"
2893
3957
  }
2894
3958
  },
2895
3959
  "required": [
2896
3960
  "country_code"
2897
3961
  ],
2898
- "type": "object"
3962
+ "type": "object",
3963
+ "x-lcp-pii": "internal"
2899
3964
  },
2900
3965
  "mortgage_purpose": {
2901
3966
  "enum": [
@@ -2905,12 +3970,14 @@
2905
3970
  "debt_consolidation"
2906
3971
  ],
2907
3972
  "ping_safe": true,
2908
- "type": "string"
3973
+ "type": "string",
3974
+ "x-lcp-pii": "public"
2909
3975
  },
2910
3976
  "property_address": {
2911
3977
  "description": "Full property address. PII \u2014 never in ping.",
2912
3978
  "ping_safe": false,
2913
- "type": "string"
3979
+ "type": "string",
3980
+ "x-lcp-pii": "contact"
2914
3981
  },
2915
3982
  "property_type": {
2916
3983
  "enum": [
@@ -2922,7 +3989,8 @@
2922
3989
  "land"
2923
3990
  ],
2924
3991
  "ping_safe": true,
2925
- "type": "string"
3992
+ "type": "string",
3993
+ "x-lcp-pii": "public"
2926
3994
  },
2927
3995
  "property_value_band": {
2928
3996
  "enum": [
@@ -2934,26 +4002,31 @@
2934
4002
  "over_1m"
2935
4003
  ],
2936
4004
  "ping_safe": true,
2937
- "type": "string"
4005
+ "type": "string",
4006
+ "x-lcp-pii": "public"
2938
4007
  },
2939
4008
  "property_value_cents": {
2940
4009
  "description": "Estimated property value. Not ping_safe \u2014 could narrow identity.",
2941
4010
  "minimum": 0,
2942
4011
  "ping_safe": false,
2943
- "type": "integer"
4012
+ "type": "integer",
4013
+ "x-lcp-pii": "restricted"
2944
4014
  },
2945
4015
  "schema_version": {
2946
4016
  "const": "1.0.0",
2947
- "type": "string"
4017
+ "type": "string",
4018
+ "x-lcp-pii": "public"
2948
4019
  },
2949
4020
  "self_employed_income_verified": {
2950
4021
  "description": "For self-employed leads, whether income has been verified; sensitive financial data, post-only.",
2951
4022
  "ping_safe": false,
2952
- "type": "boolean"
4023
+ "type": "boolean",
4024
+ "x-lcp-pii": "restricted"
2953
4025
  },
2954
4026
  "vertical": {
2955
4027
  "const": "mortgage",
2956
- "type": "string"
4028
+ "type": "string",
4029
+ "x-lcp-pii": "public"
2957
4030
  },
2958
4031
  "veteran_status": {
2959
4032
  "description": "Veteran or military status is sensitive eligibility data; post-only.",
@@ -2964,7 +4037,8 @@
2964
4037
  "non_veteran"
2965
4038
  ],
2966
4039
  "ping_safe": false,
2967
- "type": "string"
4040
+ "type": "string",
4041
+ "x-lcp-pii": "restricted"
2968
4042
  }
2969
4043
  },
2970
4044
  "required": [
@@ -2984,7 +4058,8 @@
2984
4058
  "description": "Exact accident date. Post-only; never include in a ping.",
2985
4059
  "format": "date",
2986
4060
  "ping_safe": false,
2987
- "type": "string"
4061
+ "type": "string",
4062
+ "x-lcp-pii": "restricted"
2988
4063
  },
2989
4064
  "accident_date_band": {
2990
4065
  "description": "Age band of the accident; never expose an exact date in a ping.",
@@ -2996,7 +4071,8 @@
2996
4071
  "over_12_months"
2997
4072
  ],
2998
4073
  "ping_safe": true,
2999
- "type": "string"
4074
+ "type": "string",
4075
+ "x-lcp-pii": "public"
3000
4076
  },
3001
4077
  "accident_type": {
3002
4078
  "enum": [
@@ -3011,17 +4087,20 @@
3011
4087
  "other"
3012
4088
  ],
3013
4089
  "ping_safe": true,
3014
- "type": "string"
4090
+ "type": "string",
4091
+ "x-lcp-pii": "public"
3015
4092
  },
3016
4093
  "additional_context": {
3017
4094
  "description": "Free text may contain sensitive information and is post-only.",
3018
4095
  "ping_safe": false,
3019
- "type": "string"
4096
+ "type": "string",
4097
+ "x-lcp-pii": "restricted"
3020
4098
  },
3021
4099
  "claim_filed": {
3022
4100
  "description": "Claim status is sensitive legal/insurance data; post-only.",
3023
4101
  "ping_safe": false,
3024
- "type": "boolean"
4102
+ "type": "boolean",
4103
+ "x-lcp-pii": "internal"
3025
4104
  },
3026
4105
  "claim_stage": {
3027
4106
  "enum": [
@@ -3033,11 +4112,13 @@
3033
4112
  "unknown"
3034
4113
  ],
3035
4114
  "ping_safe": true,
3036
- "type": "string"
4115
+ "type": "string",
4116
+ "x-lcp-pii": "public"
3037
4117
  },
3038
4118
  "commercial_vehicle_involved": {
3039
4119
  "ping_safe": true,
3040
- "type": "boolean"
4120
+ "type": "boolean",
4121
+ "x-lcp-pii": "public"
3041
4122
  },
3042
4123
  "consumer_insured": {
3043
4124
  "description": "Consumer insurance status is sensitive insurance data; post-only.",
@@ -3047,12 +4128,14 @@
3047
4128
  "unknown"
3048
4129
  ],
3049
4130
  "ping_safe": false,
3050
- "type": "string"
4131
+ "type": "string",
4132
+ "x-lcp-pii": "internal"
3051
4133
  },
3052
4134
  "emergency_services_called": {
3053
4135
  "description": "Emergency-response information is sensitive incident data; post-only.",
3054
4136
  "ping_safe": false,
3055
- "type": "boolean"
4137
+ "type": "boolean",
4138
+ "x-lcp-pii": "restricted"
3056
4139
  },
3057
4140
  "evidence_available": {
3058
4141
  "description": "Presence indicators only. The actual records are represented by encrypted attachments.",
@@ -3070,7 +4153,8 @@
3070
4153
  },
3071
4154
  "ping_safe": true,
3072
4155
  "type": "array",
3073
- "uniqueItems": true
4156
+ "uniqueItems": true,
4157
+ "x-lcp-pii": "public"
3074
4158
  },
3075
4159
  "fault_position": {
3076
4160
  "description": "Fault position is sensitive legal/liability data; post-only.",
@@ -3082,12 +4166,14 @@
3082
4166
  "unknown"
3083
4167
  ],
3084
4168
  "ping_safe": false,
3085
- "type": "string"
4169
+ "type": "string",
4170
+ "x-lcp-pii": "restricted"
3086
4171
  },
3087
4172
  "injury_present": {
3088
4173
  "description": "Injury indicator is sensitive health/legal data; post-only.",
3089
4174
  "ping_safe": false,
3090
- "type": "boolean"
4175
+ "type": "boolean",
4176
+ "x-lcp-pii": "restricted"
3091
4177
  },
3092
4178
  "injury_severity_band": {
3093
4179
  "description": "Injury severity is sensitive health/legal data; post-only.",
@@ -3100,12 +4186,14 @@
3100
4186
  "unknown"
3101
4187
  ],
3102
4188
  "ping_safe": false,
3103
- "type": "string"
4189
+ "type": "string",
4190
+ "x-lcp-pii": "restricted"
3104
4191
  },
3105
4192
  "jurisdiction": {
3106
4193
  "description": "State, province, or territory where the accident occurred. Prefer core location for the consumer's current location.",
3107
4194
  "ping_safe": true,
3108
- "type": "string"
4195
+ "type": "string",
4196
+ "x-lcp-pii": "internal"
3109
4197
  },
3110
4198
  "medical_treatment": {
3111
4199
  "description": "Medical treatment is sensitive health data; post-only.",
@@ -3118,12 +4206,14 @@
3118
4206
  "unknown"
3119
4207
  ],
3120
4208
  "ping_safe": false,
3121
- "type": "string"
4209
+ "type": "string",
4210
+ "x-lcp-pii": "restricted"
3122
4211
  },
3123
4212
  "other_driver_identified": {
3124
4213
  "description": "Other-party identification status is sensitive incident data; post-only.",
3125
4214
  "ping_safe": false,
3126
- "type": "boolean"
4215
+ "type": "boolean",
4216
+ "x-lcp-pii": "restricted"
3127
4217
  },
3128
4218
  "other_driver_insured": {
3129
4219
  "description": "Other-party insurance status is sensitive insurance data; post-only.",
@@ -3133,7 +4223,8 @@
3133
4223
  "unknown"
3134
4224
  ],
3135
4225
  "ping_safe": false,
3136
- "type": "string"
4226
+ "type": "string",
4227
+ "x-lcp-pii": "internal"
3137
4228
  },
3138
4229
  "passenger_count_band": {
3139
4230
  "enum": [
@@ -3144,26 +4235,31 @@
3144
4235
  "unknown"
3145
4236
  ],
3146
4237
  "ping_safe": true,
3147
- "type": "string"
4238
+ "type": "string",
4239
+ "x-lcp-pii": "public"
3148
4240
  },
3149
4241
  "police_report_available": {
3150
4242
  "description": "Police-report availability is sensitive incident data; post-only.",
3151
4243
  "ping_safe": false,
3152
- "type": "boolean"
4244
+ "type": "boolean",
4245
+ "x-lcp-pii": "restricted"
3153
4246
  },
3154
4247
  "prior_attorney_consultation": {
3155
4248
  "description": "Prior legal consultation is sensitive legal data; post-only.",
3156
4249
  "ping_safe": false,
3157
- "type": "boolean"
4250
+ "type": "boolean",
4251
+ "x-lcp-pii": "restricted"
3158
4252
  },
3159
4253
  "represented_by_attorney": {
3160
4254
  "description": "Attorney-representation status is sensitive legal data; post-only.",
3161
4255
  "ping_safe": false,
3162
- "type": "boolean"
4256
+ "type": "boolean",
4257
+ "x-lcp-pii": "restricted"
3163
4258
  },
3164
4259
  "schema_version": {
3165
4260
  "const": "1.0.0",
3166
- "type": "string"
4261
+ "type": "string",
4262
+ "x-lcp-pii": "public"
3167
4263
  },
3168
4264
  "vehicle_count_band": {
3169
4265
  "enum": [
@@ -3173,11 +4269,13 @@
3173
4269
  "unknown"
3174
4270
  ],
3175
4271
  "ping_safe": true,
3176
- "type": "string"
4272
+ "type": "string",
4273
+ "x-lcp-pii": "public"
3177
4274
  },
3178
4275
  "vertical": {
3179
4276
  "const": "mva",
3180
- "type": "string"
4277
+ "type": "string",
4278
+ "x-lcp-pii": "public"
3181
4279
  }
3182
4280
  },
3183
4281
  "required": [
@@ -3196,7 +4294,8 @@
3196
4294
  "battery_storage_interest": {
3197
4295
  "description": "Consumer interest in battery storage.",
3198
4296
  "ping_safe": true,
3199
- "type": "boolean"
4297
+ "type": "boolean",
4298
+ "x-lcp-pii": "public"
3200
4299
  },
3201
4300
  "current_energy_source": {
3202
4301
  "description": "Current energy source.",
@@ -3209,7 +4308,8 @@
3209
4308
  "other"
3210
4309
  ],
3211
4310
  "ping_safe": true,
3212
- "type": "string"
4311
+ "type": "string",
4312
+ "x-lcp-pii": "public"
3213
4313
  },
3214
4314
  "installation_timeline": {
3215
4315
  "description": "Desired installation timeline.",
@@ -3221,7 +4321,8 @@
3221
4321
  "exploring"
3222
4322
  ],
3223
4323
  "ping_safe": true,
3224
- "type": "string"
4324
+ "type": "string",
4325
+ "x-lcp-pii": "public"
3225
4326
  },
3226
4327
  "monthly_electric_bill_band": {
3227
4328
  "description": "Banded monthly electric bill in dollars.",
@@ -3234,7 +4335,8 @@
3234
4335
  "over_500"
3235
4336
  ],
3236
4337
  "ping_safe": true,
3237
- "type": "string"
4338
+ "type": "string",
4339
+ "x-lcp-pii": "public"
3238
4340
  },
3239
4341
  "number_of_panels_band": {
3240
4342
  "description": "Banded number of solar panels.",
@@ -3246,7 +4348,8 @@
3246
4348
  "over_40"
3247
4349
  ],
3248
4350
  "ping_safe": true,
3249
- "type": "string"
4351
+ "type": "string",
4352
+ "x-lcp-pii": "public"
3250
4353
  },
3251
4354
  "ownership": {
3252
4355
  "description": "Property ownership status.",
@@ -3255,7 +4358,8 @@
3255
4358
  "rent"
3256
4359
  ],
3257
4360
  "ping_safe": true,
3258
- "type": "string"
4361
+ "type": "string",
4362
+ "x-lcp-pii": "public"
3259
4363
  },
3260
4364
  "property_type": {
3261
4365
  "enum": [
@@ -3267,7 +4371,8 @@
3267
4371
  "other"
3268
4372
  ],
3269
4373
  "ping_safe": true,
3270
- "type": "string"
4374
+ "type": "string",
4375
+ "x-lcp-pii": "public"
3271
4376
  },
3272
4377
  "roof_type": {
3273
4378
  "description": "Roof material type.",
@@ -3281,11 +4386,13 @@
3281
4386
  "other"
3282
4387
  ],
3283
4388
  "ping_safe": true,
3284
- "type": "string"
4389
+ "type": "string",
4390
+ "x-lcp-pii": "public"
3285
4391
  },
3286
4392
  "schema_version": {
3287
4393
  "const": "1.0.0",
3288
- "type": "string"
4394
+ "type": "string",
4395
+ "x-lcp-pii": "public"
3289
4396
  },
3290
4397
  "shade_level": {
3291
4398
  "description": "Roof shade level affecting solar production.",
@@ -3295,7 +4402,8 @@
3295
4402
  "significant"
3296
4403
  ],
3297
4404
  "ping_safe": true,
3298
- "type": "string"
4405
+ "type": "string",
4406
+ "x-lcp-pii": "public"
3299
4407
  },
3300
4408
  "system_size_kw_band": {
3301
4409
  "description": "Banded solar system size in kilowatts.",
@@ -3307,16 +4415,19 @@
3307
4415
  "over_20kw"
3308
4416
  ],
3309
4417
  "ping_safe": true,
3310
- "type": "string"
4418
+ "type": "string",
4419
+ "x-lcp-pii": "public"
3311
4420
  },
3312
4421
  "utility_provider": {
3313
4422
  "description": "Current utility provider name.",
3314
4423
  "ping_safe": true,
3315
- "type": "string"
4424
+ "type": "string",
4425
+ "x-lcp-pii": "internal"
3316
4426
  },
3317
4427
  "vertical": {
3318
4428
  "const": "solar",
3319
- "type": "string"
4429
+ "type": "string",
4430
+ "x-lcp-pii": "public"
3320
4431
  }
3321
4432
  },
3322
4433
  "required": [