---
title: "Get customer"
method: GET
path: "/customers/{id}"
tags: ["Customers"]
---

# Get customer

`GET /customers/{id}`

## Request

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

## Path parameters

- `id` integer, required

## Headers

- `x-organization-id` integer

## Response `200`

Successfully retrieved customer information

- object
  - `customer` ExternalCustomer, 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, required: Customer custom fields, keyed by field label

## Other responses

- `400`: Invalid request
- `401`: Invalid token
- `404`: Could not find the specified customer or the user cannot access it.

## 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/:id/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)