Skip to main content
Version: v4

search_response_ServiceEndpointSnippet

A ServiceEndpoint hit snippet: the [TG-FCT-6a] core — which includes type and the verbatim serviceEndpoint, the payload of the surface — plus the didCard group when selected (default set).

idsearch_response_DidStringrequired

Possible values: Value must match regular expression ^did:

didIdsearch_response_DidStringrequired

The owning DID (the Did of the EXPOSES_SERVICE edge), per [TG-FCT-6a].

Possible values: Value must match regular expression ^did:

typestringrequired
serviceEndpoint objectrequired

Endpoint value preserved verbatim per DID-CORE (URI string or object).

anyOf
string<uri>
lastObservedAtTimestring<date-time>required

ISO 8601 / RFC 3339 datetime string in UTC.

Possible values: Value must match regular expression ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$

didCard object

[TG-FCT-6b] didCard group — the owning DID as a card. Present iff selected (default set).

didsearch_response_DidStringrequired

Possible values: Value must match regular expression ^did:

trustedbooleanrequired
isTrustExpiredbooleanrequired
service objectrequired

Same shape and null conditions as the Did-surface service group.

oneOf

[TG-FCT-6b] service group: the VS-level identity asserted by the ServiceCredential. The group is null (not this object) when the DID presents no ServiceCredential.

patternstringrequired

Architecture pattern (Did.pattern); non-null whenever a ServiceCredential exists.

Possible values: [A, B]

namestringrequired

ServiceCredential.name.

typestringrequired

ServiceCredential.type — the declared VS service category.

descriptionstringrequired

ServiceCredential.description, optionally truncated for card use (truncation ends at a character boundary and is flagged with a trailing …).

logoUristring<uri>required

ServiceCredential.logoUri.

logoDigestSrisearch_response_DigestSrirequired

ServiceCredential.logoDigestSri.

Possible values: Value must match regular expression ^sha(256|384|512)-

property name*any

[TG-FCT-6b] service group: the VS-level identity asserted by the ServiceCredential. The group is null (not this object) when the DID presents no ServiceCredential.

operator objectrequired

Same shape and null conditions as the Did-surface operator group.

oneOf

[TG-FCT-6b] operator group: the operative ORG-or-PERSONA identity the VS's trust chain rests on (Pattern A: self; Pattern B: issuer), per the [TG-FCT-3] derivation. The group is null (not this object) when the trust chain is incomplete.

kindstringrequired

Derived facet per [TG-FCT-3].

Possible values: [Organization, Persona]

namestringrequired

Operative OrganizationCredential.name or PersonaCredential.name.

logoUri(string | null)<uri>nullablerequired

Operative OrganizationCredential.logoUri or PersonaCredential.avatarUri; null for a Persona without avatar.

logoDigestSri objectrequired

Paired OrganizationCredential.logoDigestSri or PersonaCredential.avatarDigestSri; null under the same conditions as logoUri.

anyOf
search_response_DigestSri

Possible values: Value must match regular expression ^sha(256|384|512)-

countryCodestringrequired

Operative OrganizationCredential.countryCode or PersonaCredential.controllerCountryCode.

Possible values: Value must match regular expression ^[A-Z]{2}$

registryIdstring | nullnullablerequired

Operative OrganizationCredential.registryId; null when the operator is a Persona.

addressstring | nullnullablerequired

Operative OrganizationCredential.address; null when the operator is a Persona.

property name*any

[TG-FCT-6b] operator group: the operative ORG-or-PERSONA identity the VS's trust chain rests on (Pattern A: self; Pattern B: issuer), per the [TG-FCT-3] derivation. The group is null (not this object) when the trust chain is incomplete.

property name*any

[TG-FCT-6b] didCard group — the owning DID as a card. Present iff selected (default set).

property name*any

A ServiceEndpoint hit snippet: the [TG-FCT-6a] core — which includes type and the verbatim serviceEndpoint, the payload of the surface — plus the didCard group when selected (default set).

search_response_ServiceEndpointSnippet
{
"id": "string",
"didId": "string",
"type": "string",
"serviceEndpoint": "string",
"lastObservedAtTime": "2024-07-29T15:51:28.071Z",
"didCard": {
"did": "string",
"trusted": true,
"isTrustExpired": true,
"service": {
"name": "string",
"type": "string",
"description": "string",
"logoUri": "string",
"logoDigestSri": "string"
},
"operator": {
"name": "string",
"logoUri": "string",
"logoDigestSri": "string",
"countryCode": "string",
"registryId": "string",
"address": "string"
}
}
}