LoginLog

Stored in the loginlogs collection.

Returned by GET /logs/login.

Example

One real LoginLog as returned by GET /logs/login, taken from the data array. Recorded from a live response, so the defaults, denormalised snapshots and populated fields are the actual ones:

{
  "_id": "6a9572ef859eafb47bf22617",
  "user": {
    "_id": "6a9572df859eafb47bf225d6",
    "name": "Docs Test User",
    "email": "test@test.test"
  },
  "email": "test@test.test",
  "ipAddress": "127.0.0.1",
  "userAgent": "curl/8.18.0",
  "status": "success",
  "reason": null,
  "error": null,
  "createdAt": "2026-08-31T12:26:23.662Z",
  "__v": 0,
  "member": {
    "_id": "6a9572df859eafb47bf225d9",
    "email": "test@test.test",
    "status": "owner"
  }
}

:::note Trimmed for reading A populated reference is shown by the fields that identify it rather than in full — it arrives as the entire referenced document. Long arrays are cut to the first two entries and marked, long strings are truncated, and any field that could carry a credential is dropped rather than masked. :::

Fields

Field	Type	Notes
user	ObjectId -> User	required
email	string	required
ipAddress	string
userAgent	string
status	string	required · one of success, failure
reason	string
error	any
createdAt	date	default now
_id	ObjectId