Appearance
Version Service
The Version Service offers functionality around versioning, tracking and searching of many different types ("methods") of Decentralized Identifiers (DIDs).
This includes looking up historical versions of DIDs and DID documents, search for DIDs based on the DID (the identifier itself) or DID document contents, as well as various tracking, auditing and analytics functions.
API
See API Reference.
Historical lookup
Historical lookup can be used both within a given DID method, or for a specific DID.
List latest DIDs in a DID method
This request lists the 5 latest DIDs within the indy DID method:
bash
curl -X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?method=indy&limit=5" \
-H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-H "Accept: application/json"1
2
3
2
3
Look up a DID at a specific point in time
This request resolves the DID did:indy:sovrin:Uarrb25Y6v2jhLCJyqTKE7 at the time 2024-05-15T00:00:00Z:
bash
curl -X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:sovrin:Uarrb25Y6v2jhLCJyqTKE7?versionTime=2024-05-15T00:00:00Z&limit=1" \
-H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-H "Accept: application/json"1
2
3
2
3
Removing limit=1 from the query resolves all the versions of the DID did:indy:sovrin:Uarrb25Y6v2jhLCJyqTKE7 up through 2024-05-15T00:00:00Z:
bash
curl -X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:sovrin:Uarrb25Y6v2jhLCJyqTKE7?versionTime=2024-05-15T00:00:00Z" \
-H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-H "Accept: application/json"1
2
3
2
3
Search for DIDs
Searching is possible both by the DID (the identifier itself) and by DID document contents.
Search by DID content
This request searches for a DID containing the string WRfXPg8dantKVubE3HX8pw:
bash
curl -X GET "https://api.godiddy.com/1.0.0/version-service/didrecords/findInIdentifier?term=WRfXPg8dantKVubE3HX8pw" \
-H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-H "Accept: application/json"1
2
3
2
3
Search by DID document content
This request searches for DIDs containing a verification method of type Ed25519VerificationKey2018:
bash
curl -X GET "https://api.godiddy.com/1.0.0/version-service/diddocuments/search?path=verificationMethod&path=type&value=Ed25519VerificationKey2018" \
-H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-H "Accept: application/json"1
2
3
2
3