---
title: "Get Customer (getCustomerById)"
method: GET
path: "/api/customer/{customerId}"
tags: ["customer-controller"]
---

# Get Customer (getCustomerById)

`GET /api/customer/{customerId}`

Get the Customer object based on the provided Customer Id. If the user has the authority of 'Tenant Administrator', the server checks that the customer is owned by the same tenant. If the user has the authority of 'Customer User', the server checks that the user belongs to the customer.

Available for users with 'TENANT_ADMIN' or 'CUSTOMER_USER' authority.

## Path parameters

- `customerId` string, required

## Response `200`

OK

- Customer
  - `id` CustomerId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'CUSTOMER', required — string
  - `createdTime` integer — Timestamp of the customer creation, in milliseconds
  - `country` string — Country
  - `state` string — State
  - `city` string — City
  - `address` string — Address Line 1
  - `address2` string — Address Line 2
  - `zip` string — Zip code
  - `phone` string — Phone number
  - `email` string, required — Email
  - `title` string, required — Title of the customer
  - `tenantId` TenantId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `version` integer
  - `name` string — Name of the customer. Read-only, duplicated from title for backward compatibility
  - `additionalInfo` unknown

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)