Skip to content

Contact Lookup Result v1

Source schema: doc/schemas/contact-lookup-result.v1.schema.json

Route-set result of a Contact Catalog lookup. A positive result is a lookup-safe route candidate, not identity assurance and not proof that a relationship exists.

Governing Basis

Project Lineage

Stories

Fields

Field Required Shape Description
schema yes const: contact-lookup-result.v1
schema/v yes const: 1
lookup/id yes string
catalog/id no string
lookup/mode yes enum: invitation-only, blinded-digest, psi
match/class yes enum: invitation-available, ambiguous, no-match, policy-denied, rate-limited
result/routes yes array
selected/route no ref: #/$defs/route
valid/until no string
policy/ref no string
issued/at yes string

Definitions

Definition Shape Description
route object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "match/class": {
      "const": "invitation-available"
    }
  },
  "required": [
    "match/class"
  ]
}

Then:

{
  "required": [
    "selected/route"
  ],
  "properties": {
    "result/routes": {
      "minItems": 1
    }
  }
}

Field Semantics

schema

  • Required: yes
  • Shape: const: contact-lookup-result.v1

schema/v

  • Required: yes
  • Shape: const: 1

lookup/id

  • Required: yes
  • Shape: string

catalog/id

  • Required: no
  • Shape: string

lookup/mode

  • Required: yes
  • Shape: enum: invitation-only, blinded-digest, psi

match/class

  • Required: yes
  • Shape: enum: invitation-available, ambiguous, no-match, policy-denied, rate-limited

result/routes

  • Required: yes
  • Shape: array

selected/route

  • Required: no
  • Shape: ref: #/$defs/route

valid/until

  • Required: no
  • Shape: string

policy/ref

  • Required: no
  • Shape: string

issued/at

  • Required: yes
  • Shape: string

Definition Semantics

$defs.route

  • Shape: object