API reference
List entry versions
Contract and client context
Operation: list_entry_versions · HTTP: GET /v1/entries/{did}/versions
Use an operator-supplied registry base URL. Request execution is disabled in this documentation explorer. Generated request snippets are templates, not signed or authorized submissions.
Exact operation definition
{
"operationId": "list_entry_versions",
"parameters": [
{
"description": "OAS DID of the entry",
"in": "path",
"name": "did",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "Maximum number of versions to return. The server clamps this to its\nconfigured maximum page size.",
"in": "query",
"name": "limit",
"required": false,
"schema": {
"format": "int64",
"minimum": 1,
"type": "integer"
}
},
{
"description": "Registry sequence of the last version returned by the preceding page.\n\nClients must treat the value as opaque and echo it unchanged.",
"in": "query",
"name": "cursor",
"required": false,
"schema": {
"pattern": "^[1-9][0-9]*$",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EntryVersionsResponse"
}
}
},
"description": "Bounded version page in stable newest-first sequence order"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Entry not found"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Read rate limit exceeded"
}
},
"tags": [
"entries"
]
}Resolve schema references against the complete OpenAPI document. Standalone schemas and hashes are generated from the same checked-in source.
GET
/v1/entries/{did}/versionsPath Parameters
did*string
OAS DID of the entry
Query Parameters
limit?integer
Maximum number of versions to return. The server clamps this to its configured maximum page size.
Format
int64Range
1 <= valuecursor?string
Registry sequence of the last version returned by the preceding page.
Clients must treat the value as opaque and echo it unchanged.
Match
^[1-9][0-9]*$Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/entries/string/versions"{ "cursor": "string", "entryDid": "string", "hasMore": true, "totalCount": 0, "versions": [ { "accessPolicy": null, "anchorState": "unanchored", "bondReference": null, "customMetadata": { "property1": null, "property2": null }, "description": "string", "entryDid": "string", "entryType": "AgentDefinition", "itemData": null, "itemDataHash": "string", "itemSchemaUri": "string", "lifecycleStatus": "draft", "lineageReference": null, "marsVersion": "string", "name": "string", "publishedAt": "2019-08-24T14:15:22Z", "publisherDid": "string", "relationships": [ { "label": "string", "relationshipType": "dependsOn", "targetDid": "string" } ], "semanticAnnotations": [ { "objectLiteral": "string", "objectUri": "string", "predicateUri": "string" } ], "sequence": 0, "serviceEndpoints": [ { "id": "string", "priority": 0, "properties": { "property1": null, "property2": null }, "type": "string", "url": "string" } ], "shardAssignment": "string", "signature": { "algorithm": "string", "created": "string", "keyId": "string", "value": "string" }, "tags": [ "string" ], "updatedAt": "2019-08-24T14:15:22Z", "verifiableAttestations": [ null ], "version": "string" } ]}