Create credential report

POST/v1/events/credential-reports

Creates a report of credential lifecycle operations (issuance and status changes).

Only CWT and mDoc credentials are included in the report.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

The credential report parameters

timezoneOffset*string

Timezone offset for the report in ISO-8601 format. For example, "+02:00" or "-05:00". This is used to determine the date boundaries for the report. For example, if the timezone offset is "+02:00", an operation that occurred at 2026-02-25T22:30:00Z would be counted towards 2026-02-26 in the report, while if the timezone offset is "-05:00", it would be counted towards 2026-02-25.

startDate*string

Start date for the report (inclusive) in ISO-8601 format. The date is interpreted based on the provided timezone offset.

Formatdate

endDate*string

End date for the report (inclusive) in ISO-8601 format. The date is interpreted based on the provided timezone offset.

Formatdate

profiles*array<>

A list of credential profiles to include in the report.

limit?integer

Maximum number of entries to include in the report. Defaults to 1000.

Default1000

cursor?string

Cursor for pagination. If not specified, the report will start from the most recent entry.

Response Body

`application/json`

`text/plain`

curl -X POST "https://example.vii.au01.mattr.global/v1/events/credential-reports" \  -H "Content-Type: application/json" \  -d '{    "timezoneOffset": "+02:00",    "startDate": "2026-02-01",    "endDate": "2026-02-28",    "profiles": [      "cwt",      "mdoc"    ]  }'

{
  "data": [
    {
      "date": "2026-02-25",
      "operation": "issued",
      "profile": "mdoc",
      "credentialType": "org.iso.18013.5.1.mDL",
      "count": 5
    }
  ],
  "nextCursor": "Y3JlYXRlZEF0PTIwMjYtMDItMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM"
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

"Unauthorized"

Empty

Create credential report

Roles

Authorization

Request Body

Response Body

200application/json

400application/json

401text/plain

403

500

`application/json`

`application/json`

`text/plain`