---
title: "List saved logins"
method: GET
path: "/v1/logins"
tags: ["logins"]
---

# List saved logins

`GET /v1/logins`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/logins`
- Auth: HTTP bearer

Lists the saved website logins you may use, as metadata only. Never returns a password or other secret. Pass site_url to list one website's logins.

## Query parameters

- `cursor` string
- `limit` string
- `site_url` string

## Response `200`

One page of saved logins

- object
  - `data` Login[], required
    - `id` string, required: a saved login ID: login_ and 32 lowercase hex digits
    - `label` string, nullable, required
    - `site` object, required
      - `url` string, required
      - `name` string, required: The site as people say it
    - `username_masked` string, required
    - `identifier_type` 'username' | 'email' | 'phone' | 'account_number', required
    - `sign_in` 'password' | 'code', required
    - `saved_fields` string[], nullable, required: What it holds besides its username and password; null when not recorded
    - `two_factor` object, required
      - `authenticator` boolean, nullable, required
      - `sms_number` 'none' | 'linked', required
    - `status` 'unverified' | 'verified' | 'needs_attention', required
    - `needs_attention` union, required
      - object
        - `field` 'username' | 'email' | 'phone' | 'account_number' | 'password', required
      - object
        - `reason` 'account_locked', required: The website said the account is locked; unlock it on the website
    - `locked` boolean, required: Personal accounts: its identity is fixed after the first verified sign-in
    - `your_access` 'use' | 'edit' | 'manage', required: use: run and build with it. edit: also reveal and change it. manage: also share and delete it
    - `created_at` string, required: When it was saved, ISO 8601 UTC
    - `updated_at` string, required: When it last changed, ISO 8601 UTC
    - `verified_at` string, nullable, required: Its first verified sign-in, ISO 8601 UTC; null before one
  - `next_cursor` string, nullable, required

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/c07cea59691c?raw)