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

# List customers

`GET /customers`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/customers`
- Auth: HTTP bearer

Endpoint used to list customer resources

## Query parameters

- `cursor` string: Last pagination reference
- `limit` integer: Maximum number of Customers returned
- `expand` string[]

## Headers

- `x-organization-id` integer

## Response `200`

Successfully fetched Customers list

- object
  - `customers` ExternalCustomerListItem[], required
    - `id` integer, required: Global ID of the customer
    - `name` string, required: Name of the customer
    - `description` string, nullable, required: Description of the customer
    - `archivedAt` string, date-time, nullable, required: Date the customer was archived. Null if the customer is active.
    - `createdAt` string, date-time, required: Date the customer was created
    - `updatedAt` string, date-time, required: Date the customer was last updated
    - `extraFields` object: Customer custom fields, keyed by field label (expand with query parameter)
    - `organizationId` integer: Organization ID when using a multi-organization token
  - `nextCursor` string, nullable, required: The cursor to retrieve the next page of Customers.
  - `nextPageUrl` string, nullable, required: Path with query parameters that can be used to retrieve the next page of Customers.

## Other responses

- `400`: Invalid request
- `401`: Invalid token

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-09-24** `67648fe5c36d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/customers/get.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)