Skip to main content

Authentication logs

Read sign-in activity and the sources responsible for failed attempts.

Endpoints

ScreenMethodEndpoint
Authentication logsPOST/ad/GetAuthLog
User authentication logsPOST/ad/GetUserAuthLog
Authentication bad sourcesPOST/ad/GetAuthBadSources
Lockout eventsPOST/ad/GetLockoutEvents
Lockout bad sourcesPOST/ad/GetLockoutBadSources

Choosing an endpoint

GetAuthLog returns activity across the domain; GetUserAuthLog narrows to a single user. The two bad-sources endpoints aggregate by originating host rather than listing individual events, which is what you want when investigating a spike.

Time ranges

Log endpoints accept a time window in the request body. The parameter names and accepted format have not been supplied.

Payloads needed.

Date range parameters, page limits and the event record shape are undocumented for all five log endpoints.