---
title: "Get user IP report"
method: GET
path: "/api/admin/users/{user_id}/ip-report"
tags: ["admin"]
---

# Get user IP report

`GET /api/admin/users/{user_id}/ip-report`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Where an account signed up and signed in from, the other accounts on
those IPs or its email domain, and the blocks covering them. Admin-only.

## Path parameters

- `user_id` string, required

## Response `200`

Successful Response

- AccountIPReport
  - `retention_days` integer, required
  - `ips` AccountIP[], required
    - `ip_address` string, required
    - `display_address` string, required
    - `is_ipv6_prefix` boolean, required
    - `has_sign_up` boolean, required
    - `sign_in_count` integer, required
    - `first_seen` string, date-time, required
    - `last_seen` string, date-time, required
    - `last_user_agent` string, nullable, required
    - `other_account_count` integer, required
    - `block` AccessBlock, required
      - `id` string, required
      - `kind` 'IP' | 'EMAIL_DOMAIN', required
      - `value` string, required
      - `reason` string, required
      - `created_by_id` string, nullable, required
      - `created_by_email` string, nullable, required
      - `created_at` string, date-time, required
      - `expires_at` string, date-time, nullable, required
    - `events` IPEventEntry[], required
      - `kind` 'SIGN_UP' | 'SIGN_IN', required
      - `user_agent` string, nullable, required
      - `created_at` string, date-time, required
    - `event_count` integer, required
  - `domain` EmailDomainInfo, required
    - `value` string, required
    - `is_public_provider` boolean, required
    - `other_account_count` integer, required
    - `block` AccessBlock, required
      - `id` string, required
      - `kind` 'IP' | 'EMAIL_DOMAIN', required
      - `value` string, required
      - `reason` string, required
      - `created_by_id` string, nullable, required
      - `created_by_email` string, nullable, required
      - `created_at` string, date-time, required
      - `expires_at` string, date-time, nullable, required
  - `related` RelatedAccount[], required
    - `id` string, required
    - `email` string, required
    - `name` string, required
    - `role` string, nullable, required
    - `created_at` string, date-time, required
    - `banned` boolean, required
    - `ban_expires` string, date-time, nullable, required
    - `has_profile` boolean, required
    - `via_ips` string[], required
    - `via_domain` boolean, required
    - `plan` string, nullable, required
    - `payment_status` 'trialing' | 'active' | 'past_due' | 'canceled' | 'granted' | 'no_subscription', required
  - `related_total` integer, required

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-10-21** `b7713814eaed`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/admin/users/:user_id/ip-report/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/c508818c16ad?raw)