Community articlePassword statistics GET9.0.1
Added by api wiki on September 23, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Gets password statistics for the authenticated user.

The password statistics resource represents essential information about the user's Notes and HTTP (or Internet) passwords.  When you send a GET request to this resource, the core service responds with a JSON response indicating:

  • the required change interval for the Notes and/or Internet passwords.
  • properties of the Internet password including whether it expires, when it was last changed, whether it can be changed over HTTP, and so on.
  • properties of the Notes password including whether it expires, when it was last changed and so on.

The Internet password properties simply reflect the data in the user's person document and/or effective security policy.  The service returns this data even if Domino is not actively managing the HTTP password.

This request must include authorization credentials.

Method URI Description
GET /api/core/pwstats Gets password statistics for the authenticated user.
Output
Code Description
200
OK. Indicates that the request was processed successfully.
401
Unauthorized. Returned when the request doesn't include authorization credentials or the credentials are invalid.
Examples
This example shows the response for a user whose Internet password is set to expire every 90 days. The user's Notes password doesn't expire.
GET /api/core/pwstats

Response returned by the server
{
  "changeinterval": 90,
  "internetpassword": {
    "syncwithnotes": false,
    "lastchangedate": "2013-08-05T13:43:55Z",
    "expires": true,
    "changeoverhttp": true,
    "expiredate": "2013-11-03T13:43:55Z"
  },
  "notespassword": {
    "expires": false
  }
}
This example shows the response for a user whose Notes password is set to expire every 120 days. The user's Internet password doesn't expire.
GET /api/core/pwstats

Response returned by the server
{
  "changeinterval": 120,
  "internetpassword": {
    "syncwithnotes": false,
    "lastchangedate": "2009-04-17T14:23:50Z",
    "expires": false,
    "changeoverhttp": true
  },
  "notespassword": {
    "lastchangedate": "2013-07-11T18:14:12Z",
    "expires": true,
    "expiredate": "2013-11-08T18:14:12Z"
  }
}