Verify DID or URL

GET

/v1/verification

• Local development server
• Demo deployment

Resolves the Decentralized Identifier for the given DNS Domain name or DID and discovers and verifies Linked Verifiable Presentations and Credentials. Information about the identifier, the linked presentations and credentials and the verification result are returned.

Related specifications:

• DIF Well-Known DID Configuration https://identity.foundation/.well-known/resources/did-configuration/
• W3C DID Resolution https://www.w3.org/TR/did-1.0/#did-resolution
• DIF Linked Verifiable Presentation https://identity.foundation/linked-vp/

Parameters

Query Parameters

q

required

string format: uri

DNS domain name or DID to verify. If no path has been specified in the URL, /.well-known is appended. /did.json is appended to complete the URL in any case.

brief

boolean

If true, returns a shortened version of the verification result.

Responses

200

Verification result.

object

documents

required

List of DID documents associated with the given URL or DID

Array<object>

object

{
  "TODO": {}
}

presentations

List of Linked Verifiable Presentations and included Verifiable Credentials.

Not included if a brief result has been requested.

Array<object>

object

{
  "TODO": {}
}

credentials

required

List of Verifiable Credentials listed by Linked Verifiable Presentations associated with the given URL.

Not included if a brief result has been requested.

Array<object>

object

{
  "TODO": {}
}

results

required

Detailed list of verification results per credential.

Not included if a brief result has been requested.

Array<object>

object

{
  "TODO": {}
}

400

Bad request

404

Identifier not found for provided domain name / DID. Thus empty lists are returned for all properties.

Example

{
  "documents": [],
  "credentials": [],
  "results": []
}