---
title: "List Customers"
method: GET
path: "/v1/customer-tool/customers"
tags: ["Customer tool (read only)"]
---

# List Customers

`GET /v1/customer-tool/customers`

## Request

- Base URL: `https://api.aivikings.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aivikings.ai/v1/customer-tool/customers`
- Auth: HTTP bearer

## Query parameters

- `q` string, nullable: Literal substring of customer ID, email, name, or company; case-insensitive.
- `email` string, nullable: Exact email address, case-insensitive.
- `status` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- CustomerToolList
  - `customers` CustomerToolProfile[], required
    - `id` string, required
    - `email` string, required
    - `pending_email` string, nullable, required
    - `email_verification_required` boolean, required
    - `display_name` string, nullable, required
    - `company_name` string, nullable, required
    - `tax_id` string, nullable, required
    - `address_line_1` string, nullable, required
    - `address_line_2` string, nullable, required
    - `city` string, nullable, required
    - `state_region` string, nullable, required
    - `postal_code` string, nullable, required
    - `country_code` string, nullable, required
    - `status` string, required
    - `preferred_currency` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next_offset` integer, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar.md) · [All operations](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/llms.txt) · [OpenAPI document](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/revisions/2fc32ee9d1b1?raw)