product icon

Reporting - Expired Master Password via LastPass API

    Use this reporting API to display a list of users (active and non-federated) whose master password expired.

    API command

    expiredmasterpwlist

    Additional details

    Request

    cid
    Company ID: a mandatory integer parameter
    provhash
    Company specific provisioning hash: a mandatory string parameter
    cmd
    The API command, that is, expiredmasterpwlist: a mandatory string parameter
    data
    Additional data for the report query: an optional array parameter
    limit
    The maximum user count in the response. The default and maximum value is 500. This is an optional integer parameter in the data array.
    continuation_token

    The continuation of a previous query: an optional string parameter in the data array

    Response

    status
    The status of the response
    continuation
    Information about the remaining users
    token
    Optional data in the continuation array. This should be the continuation_token in the next query
    remaining_item_count
    Number of remaining users with expired master password that are not included in this (or previous) queries.
    items
    Array of the response data

    Request sample

    {
        "cid": 12345,
        "provhash": "***...",
        "cmd": "expiredmasterpwlist",
        "data": {
            "continuation_token": "1235",
            "limit": 10
        }
    }

    Response sample

    {
        "status": "Success",
        "continuation": {
            "token": "1235",
            "remaining_item_count": 117
        },
        "items": [
            {
                "user_id": 1234,
                "user_name": "user1@lastpass.com",
                "last_pw_change": "2022-01-13 03:30:13"
            },
            {
                "user_id": 1235,
                "user_name": "user2@lastpass.com",
                "last_pw_change": "2022-03-13 03:38:11"
            }
        ]
    }