---
title: "List App Users"
method: GET
path: "/companies/{company_id}/app-users"
tags: ["app-users"]
---

# List App Users

`GET /companies/{company_id}/app-users`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/app-users`
- Auth: HTTP bearer

The Users card / ``list_app_users`` roster (D-19).

Soft-deleted users are excluded (§10: support erasure must not leave a
ghost on the owner roster). These are SIGN-IN IDENTITIES, not a marketing
list, and the tool description and ToS carry the matching obligation; a
subscriber is a paying customer and may be written to (D21).

## Path parameters

- `company_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AppUsersListResponse
  - `users` AppUserResponse[], required
    - `sub` string, required
    - `email` string, required
    - `name` string, nullable
    - `picture` string, nullable
    - `granted_at` string, date-time, required
    - `last_login_at` string, date-time, required
    - `subscription` AppUserSubscriptionTag: The Users tag lane (D28): the user's live plan with this business. ``status`` is Stripe's string (``active`` or ``past_due``). ``cancel_at_period_end`` is what the in-app cancel funnel sets, and it is the predicate that drives the LEAVING tag, the same one the SUBSCRIBERS panel reads. ``cancel_at`` only supplies the date, and Stripe leaves it null on a cancel-at-period-end, so the route falls back to the period end.
      - `status` string, required
      - `cancel_at_period_end` boolean
      - `cancel_at` string, date-time, nullable
  - `total` integer, required
  - `enabled` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-17** `fdb61f8c4234`: 1 info
  - added the optional property `users/items/subscription` to the response with the `200` status

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/app-users/get.md)

---

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