Notifications

Mark notification as read.

post

Claim-based access control: Issuer_Admin, Issuer_Auditor, Issuer_User, Verifier_Admin, Verifier_Auditor, Verifier_User

Authorizations

COGNITO_JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

200Success

application/json

400

Invalid request body.

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

404

Notification not found.

409

Notification already marked as read.

post

/api/v1/notifications/{id}/read

HTTPcURLJavaScriptPython

POST /products/web/12345/portal/backend/api/v1/notifications/{id}/read HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "createdAt": "2026-02-05T04:58:54.823Z",
  "notification": {
    "id": "text",
    "createdAt": "2026-02-05T04:58:54.823Z",
    "userId": "text",
    "recipientCognitoSub": "text",
    "notificationType": "expired_vc",
    "notificationIcon": "error",
    "notificationRecordId": "text",
    "notificationRecordType": "credential_offer",
    "service": "issuer",
    "notificationTitle": "text",
    "notificationSubtitle": "text",
    "notificationDescription": "text"
  }
}

Mark all notifications as read.

post

Claim-based access control: Issuer_Admin, Issuer_Auditor, Issuer_User, Verifier_Admin, Verifier_Auditor, Verifier_User

Authorizations

COGNITO_JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

serviceall ofRequired

The service for which notifications are being marked as read.

string · enumOptionalPossible values:

Responses

201Success

application/json

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

post

/api/v1/notifications/mark-all-read

HTTPcURLJavaScriptPython

POST /products/web/12345/portal/backend/api/v1/notifications/mark-all-read HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "service": "issuer"
}

{
  "message": "text"
}

Get list of notifications

get

Claim-based access control: Issuer_Admin, Issuer_Auditor, Issuer_User, Verifier_Admin, Verifier_Auditor, Verifier_User

Authorizations

COGNITO_JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagenumberOptional

Page number to retrieve.If you provide invalid value the default page number will applied Example: 1 Default Value: 1

limitnumberOptional

Number of records per page. Example: 20 Default Value: 20 Max Value: 100

  If provided value is greater than max value, max value will be applied.

filter.readstring[]Optional

Filter by read query param. Format: filter.read={$not}:OPERATION:VALUE Example: filter.read=$not:$like:John Doe&filter.read=like:John Available Operations$eq

filter.servicestring[]Optional

Filter by service query param. Format: filter.service={$not}:OPERATION:VALUE Example: filter.service=$not:$like:John Doe&filter.service=like:John Available Operations$eq

Responses

200Success

application/json

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

get

/api/v1/notifications

HTTPcURLJavaScriptPython

GET /products/web/12345/portal/backend/api/v1/notifications HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "createdAt": "2026-02-05T04:58:54.823Z",
      "userId": "text",
      "recipientCognitoSub": "text",
      "notificationType": "expired_vc",
      "notificationIcon": "error",
      "notificationRecordId": "text",
      "notificationRecordType": "credential_offer",
      "service": "issuer",
      "notificationTitle": "text",
      "notificationSubtitle": "text",
      "notificationDescription": "text",
      "userRead": true
    }
  ],
  "meta": {
    "select": [
      "text"
    ],
    "filter": {
      "read": "text",
      "service": "text"
    }
  },
  "links": {
    "first": "text",
    "previous": "text",
    "current": "text",
    "next": "text",
    "last": "text"
  }
}

Get notification preferences of the request user.

get

Claim-based access control: Issuer_Admin, Issuer_Auditor, Issuer_User, Verifier_Admin, Verifier_Auditor, Verifier_User

Authorizations

COGNITO_JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200Success

application/json

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

get

/api/v1/notifications/preferences

HTTPcURLJavaScriptPython

GET /products/web/12345/portal/backend/api/v1/notifications/preferences HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "credentialStatus": {
    "claimed_vc": true,
    "expired_vc": true,
    "expiring_vc": true
  },
  "userActivity": {
    "new_user": true,
    "role_changed": true,
    "user_removed": true
  },
  "verificationStatus": {
    "verification_error": true,
    "verification_failed": true,
    "verification_valid": true
  }
}

Create or update notification preferences of the request user.

patch

Claim-based access control: Issuer_Admin, Issuer_Auditor, Issuer_User, Verifier_Admin, Verifier_Auditor, Verifier_User

Authorizations

COGNITO_JWT

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200Success

application/json

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

patch

/api/v1/notifications/preferences

HTTPcURLJavaScriptPython

PATCH /products/web/12345/portal/backend/api/v1/notifications/preferences HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 207

{
  "preferences": {
    "expired_vc": true,
    "expiring_vc": true,
    "claimed_vc": true,
    "new_user": true,
    "user_removed": true,
    "role_changed": true,
    "verification_error": true,
    "verification_failed": true,
    "verification_valid": true
  }
}

{
  "credentialStatus": {
    "claimed_vc": true,
    "expired_vc": true,
    "expiring_vc": true
  },
  "userActivity": {
    "new_user": true,
    "role_changed": true,
    "user_removed": true
  },
  "verificationStatus": {
    "verification_error": true,
    "verification_failed": true,
    "verification_valid": true
  }
}