Customers - AgentaOS

agenta customers is a quick lookup for anyone who has ever completed a checkout with you: email, name, country, VAT number if they gave one. Read-only from the CLI today.

agenta customers list

Usage

agenta customers list [--limit <n>] [--json]

number

default:"10"

Results per page, 1 to 100.

boolean

Output a single JSON object instead of a table.

Output

  Customers (2 total)

  jane@startup.io               Jane Cooper              DE   10f6f205-0f31-44c3-ad1a-240af6177e74
  ana@example.com                Ana Reyes                 ES   f5100f77-fd73-4c33-a6e7-c1c5db53804c

  2 of 2 shown.

`--json`

{
  "total": 2,
  "hasMore": false,
  "items": [
    {
      "id": "10f6f205-0f31-44c3-ad1a-240af6177e74",
      "email": "jane@startup.io",
      "name": "Jane Cooper",
      "country": "DE",
      "vatNumber": "DE123456789",
      "stripeCustomerId": "cus_Q4f...",
      "createdAt": "2026-06-11T09:15:00.000Z"
    }
  ]
}

Fields

Field	Description
`id`	Customer ID, e.g. `10f6f205-0f31-44c3-ad1a-240af6177e74`.
`email`	Buyer’s email.
`name`	Buyer’s name, `null` if never provided.
`country`	ISO 3166-1 alpha-2 country code (`DE`, `US`), `null` if unknown.
`vatNumber`	Buyer’s VAT number if they entered one at checkout.
`stripeCustomerId`	Underlying customer from the card processor, for card and bank payments.
`createdAt`	When this customer record was first created.

Piping agenta customers list to a file or another command switches to JSON automatically, no --json needed: agenta customers list --limit 100 > customers.json.

Next steps

Subscriptions

See what a customer is subscribed to.

Invoices

Pull a customer’s paid invoices and receipts.

Customers (SDK)

Look up customers from your own backend.

Customers (concept)

How customer records are created and used.

​Usage

​--json

​Fields

​Next steps

Subscriptions

Invoices

Customers (SDK)

Customers (concept)

Usage

`--json`

Fields

Next steps