---
title: "List all customers"
method: GET
path: "/customers"
tags: ["Customers"]
---

# List all customers

`GET /customers`

Retrieve a list of customers for the authenticated team.

## Query parameters

- `q` string, nullable — Search query string to filter customers by name, email, or other text fields
- `sort` string[], nullable — Sort as [column, direction]. Columns: name, created_at, contact, email, invoices, projects, tags, industry, country, total_revenue, outstanding, last_invoice. Direction: asc or desc.
- `cursor` string — Cursor for pagination, representing the last item from the previous page
- `pageSize` number — Number of customers to return per page (1-100)

## Response `200`

Retrieve a list of customers for the authenticated team.

- object
  - `meta` object, required — Pagination metadata for the customers response
    - `cursor` string, nullable, required — Cursor for the next page of results, null if no more pages
    - `hasPreviousPage` boolean, required — Whether there are more customers available on the previous page
    - `hasNextPage` boolean, required — Whether there are more customers available on the next page
  - `data` object[], required — Array of customers matching the query criteria
    - `id` string, uuid, required — Unique identifier of the customer
    - `name` string, required — Name of the customer or organization
    - `email` string, email, required — Primary email address of the customer
    - `billingEmail` string, nullable, required — Billing email addresses of the customer (comma-separated for multiple)
    - `phone` string, nullable, required — Primary phone number of the customer
    - `website` string, nullable, required — Website URL of the customer
    - `createdAt` string, required — Date and time when the customer was created in ISO 8601 format
    - `country` string, nullable, required — Country name where the customer is located
    - `addressLine1` string, nullable, required — First line of the customer's address
    - `addressLine2` string, nullable, required — Second line of the customer's address (suite, apartment, etc.)
    - `city` string, nullable, required — City where the customer is located
    - `state` string, nullable, required — State or province where the customer is located
    - `zip` string, nullable, required — ZIP or postal code of the customer's address
    - `note` string, nullable, required — Internal notes about the customer for team reference
    - `vatNumber` string, nullable, required — VAT (Value Added Tax) number of the customer
    - `countryCode` string, nullable, required — Country code in ISO 3166-1 alpha-2 format
    - `token` string, required — Unique token for the customer (used for internal identification)
    - `contact` string, nullable, required — Primary contact person's name at the customer organization
    - `invoiceCount` number, required — Total number of invoices created for this customer
    - `projectCount` number, required — Total number of projects associated with this customer
    - `totalRevenue` number — Total revenue from paid invoices for this customer (in invoice currency). Only returned in list queries.
    - `outstandingAmount` number — Total outstanding amount from unpaid/overdue invoices (in invoice currency). Only returned in list queries.
    - `lastInvoiceDate` string, nullable — Date of the most recent invoice in ISO 8601 format. Only returned in list queries.
    - `invoiceCurrency` string, nullable — Primary currency used in invoices for this customer. Only returned in list queries.
    - `tags` object[], required — Array of tags associated with the customer for categorization
      - `id` string, uuid, required — Unique identifier of the tag
      - `name` string, required — Display name of the tag
    - `description` string, nullable, required — AI-generated description of what the company does
    - `industry` string, nullable, required — Primary industry of the company
    - `companyType` string, nullable, required — Business model type
    - `employeeCount` string, nullable, required — Estimated number of employees
    - `foundedYear` number, nullable, required — Year the company was founded
    - `estimatedRevenue` string, nullable, required — Estimated annual revenue range
    - `fundingStage` string, nullable, required — Current funding stage
    - `totalFunding` string, nullable, required — Total funding raised
    - `headquartersLocation` string, nullable, required — Company headquarters location
    - `timezone` string, nullable, required — IANA timezone of the company headquarters
    - `linkedinUrl` string, nullable, required — LinkedIn company page URL
    - `twitterUrl` string, nullable, required — Twitter/X profile URL
    - `instagramUrl` string, nullable, required — Instagram profile URL
    - `facebookUrl` string, nullable, required — Facebook page URL
    - `logoUrl` string, nullable, required — URL to the company logo
    - `ceoName` string, nullable, required — Name of the CEO or founder
    - `financeContact` string, nullable, required — Name of the finance/AP contact for invoicing
    - `financeContactEmail` string, nullable, required — Email of the finance/AP contact
    - `primaryLanguage` string, nullable, required — Primary business language (ISO 639-1 code)
    - `fiscalYearEnd` string, nullable, required — Month when the fiscal year ends
    - `enrichmentStatus` string, nullable, required — Status of the enrichment process
    - `enrichedAt` string, nullable, required — When the customer was last enriched

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)