MARS documentation
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}/versions

Path 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.

Formatint64
Range1 <= value
cursor?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"    }  ]}