---
title: "List the caller's login history"
method: GET
path: "/v1/login_history"
tags: ["login-history"]
---

# List the caller's login history

`GET /v1/login_history`

## Request

- Base URL: `https://identity-api.paymongo.com`
- URL: `https://identity-api.paymongo.com/v1/login_history`
- Auth: HTTP bearer

Returns the caller's sign-ins from the last 180 days, newest first, with cursor pagination via `after` (the id of the last event on the previous page). `flagged` is true when login risk assessment found something unusual, such as a new device or impossible travel.

## Query parameters

- `limit` integer
- `after` string

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` object[]
    - `attributes` DeviceLoginEventAttributesDTO
      - `auth_method` string
      - `created_at` string
      - `device` string
      - `device_id` string
      - `factor` string
      - `flagged` boolean
      - `ip_address` string
      - `location` DeviceLoginLocationDTO
        - `city` string
        - `country_code` string
        - `country_name` string
        - `region` string
      - `outcome` string
    - `id` string
    - `type` string
  - `has_more` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paymongo/apis/identity.md) - [All operations](https://skmtc.dev/paymongo/apis/identity/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/identity/revisions/cc3056164874?raw)