MARS documentation
API reference

Get attestations

Contract and client context

Operation: get_attestations · HTTP: GET /v1/attestations/{did}

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": "get_attestations",
  "parameters": [
    {
      "description": "OAS DID of the entry",
      "in": "path",
      "name": "did",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Include credentials whose expiration date has passed.",
      "in": "query",
      "name": "includeExpired",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Include credentials revoked in the local registry.",
      "in": "query",
      "name": "includeRevoked",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "items": {
              "$ref": "#/components/schemas/VerifiableAttestationRecord"
            },
            "type": "array"
          }
        }
      },
      "description": "Verified attestations; expired and revoked omitted by default"
    },
    "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": [
    "trust"
  ]
}

Resolve schema references against the complete OpenAPI document. Standalone schemas and hashes are generated from the same checked-in source.

GET/v1/attestations/{did}

Path Parameters

did*string

OAS DID of the entry

Query Parameters

includeExpired?boolean

Include credentials whose expiration date has passed.

includeRevoked?boolean

Include credentials revoked in the local registry.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/attestations/string"
[  {    "acceptedAt": "2019-08-24T14:15:22Z",    "attestationId": "string",    "credential": null,    "entryDid": "string",    "expiresAt": "2019-08-24T14:15:22Z",    "issuedAt": "2019-08-24T14:15:22Z",    "issuerDid": "string",    "revokedAt": "2019-08-24T14:15:22Z"  }]