---
title: "List Accounts"
method: GET
path: "/v0/inboxes/{inbox_id}/accounts"
tags: ["inboxes > accounts"]
---

# List Accounts

`GET /v0/inboxes/{inbox_id}/accounts`

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/inboxes/{inbox_id}/accounts`
- Auth: HTTP bearer

Lists accounts held by the inbox, across all apps. Requires `inbox_read`.

## Path parameters

- `inbox_id` string, required: The ID of the inbox.

## Query parameters

- `limit` integer: Limit of number of items returned.
- `page_token` string: Page token for pagination.
- `ascending` boolean: Sort in ascending temporal order.

## Response `200`

Response with status 200

- AccountsListAccountsResponse
  - `count` integer, required: Number of items returned.
  - `limit` integer, required: Limit of number of items returned.
  - `next_page_token` string: Page token for pagination.
  - `accounts` AccountsAccount[], required
    - `account_id` string, uuid, required: ID of account.
    - `app_id` string, uuid, required: ID of app.
    - `app_name` string: Display name of app.
    - `inbox_id` string, required: The ID of the inbox.
    - `pod_id` string, required: ID of pod.
    - `organization_id` string, required: ID of organization.
    - `first_signed_in_at` string, date-time, required: Time of first sign-in at app.
    - `last_signed_in_at` string, date-time, required: Time of most recent sign-in at app.
    - `sign_in_count` integer, required: Number of sign-ins at app.
    - `status` 'disabled': `disabled` refuses every new sign-in for the account until it is re-enabled. Access tokens already issued are not revoked.
    - `disabled_at` string, date-time: Time at which the account was disabled. Present only while `status` is `disabled`.

## Other responses

- `400`: Error response with status 400

## Changes

- **2026-10-16** `3f5c7830c952`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/inboxes/:inbox_id/accounts/get.md)

---

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