---
title: "GET /api/integration/v1/customers — list all customers (paginated)"
method: GET
path: "/api/integration/v1/customers"
tags: ["Customers"]
---

# GET /api/integration/v1/customers — list all customers (paginated)

`GET /api/integration/v1/customers`

## Request

- Base URL: `https://api.timix.ai`
- URL: `https://api.timix.ai/api/integration/v1/customers`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `Page` integer
- `PageSize` integer
- `Skip` integer
- `CreatedAfter` string, date-time, nullable
- `UpdatedAfter` string, date-time, nullable

## Response `200`

- PagedResultOfBillingCustomerView: Paginated list wrapper returned by all Integration API list endpoints. Total count is also available via the X-Total-Count response header.
  - `items` BillingCustomerView[]: Current page items.
    - `id` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `parentId` string, required
    - `name` string, required
    - `country` string
    - `description` string
    - `contactName` string
    - `contactEmail` string
    - `contactPhone` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `status` 'Active' | 'Inactive'
    - `vatNumber` string
    - `website` string
    - `size` string
    - `currency` string
    - `times` TimeSummaries, required
      - `tm` TimeSummary
        - `reported` integer
        - `limit` integer
      - `fix` TimeSummary
        - `reported` integer
        - `limit` integer
      - `ovh` TimeSummary
        - `reported` integer
        - `limit` integer
      - `all` TimeSummary, required
        - `reported` integer
        - `limit` integer
      - `financialSummary` FinancialSummary
        - `totalRevenue` number
        - `totalCost` number
        - `totalProfit` number
        - `profitMargin` number
        - `revenueByBillingType` object
        - `costByUser` object
        - `monthlyBreakdown` object
    - `organizationId` string
    - `createdBy` string
    - `updatedBy` string
    - `customFields` object, nullable
  - `totalCount` integer: Total number of matching records across all pages.
  - `page` integer: Current page number (1-based).
  - `pageSize` integer: Items per page.
  - `hasMore` boolean: Whether there are more pages.

---

[API](https://skmtc.dev/timix/apis/timix-ai-integration-api.md) · [All operations](https://skmtc.dev/timix/apis/timix-ai-integration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timix/apis/timix-ai-integration-api/revisions/ff7f1b6d7479?raw)