> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telemetron.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Customer by ID

> Retrieve customer by ID

## Overview

Retrieves customer information by their Telemetron customer ID. Response includes assigned devices.

## Authentication

<ParamField header="x-api-key" type="string" required>
  Your organization's API key
</ParamField>

## Path Parameters

<ParamField path="telemetronCustomerId" type="string" required>
  The unique customer identifier
</ParamField>

## Response

<ResponseField name="id" type="string">
  The unique customer identifier (telemetronCustomerId)
</ResponseField>

<ResponseField name="organizationId" type="string">
  The organization ID this customer belongs to
</ResponseField>

<ResponseField name="name" type="string">
  Customer's full name
</ResponseField>

<ResponseField name="email" type="string">
  Customer's email address
</ResponseField>

<ResponseField name="phone" type="string">
  Customer's phone number (if provided)
</ResponseField>

<ResponseField name="address" type="string">
  Customer's address (if provided)
</ResponseField>

<ResponseField name="devices" type="array">
  Array of device identifiers assigned to this customer
</ResponseField>

<ResponseField name="orders" type="array">
  Array of order identifiers associated with this customer
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional customer metadata
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the customer was created
</ResponseField>

## Examples

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
    -H "x-api-key: your_api_key_here"
  ```

  ```javascript JavaScript theme={null}
  const customerId = 'cust_a1b2c3d4e5f6';
  const response = await fetch(
    `https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/${customerId}`,
    {
      method: 'GET',
      headers: {
        'x-api-key': 'your_api_key_here'
      }
    }
  );

  const customer = await response.json();
  ```

  ```python Python theme={null}
  import requests

  customer_id = 'cust_a1b2c3d4e5f6'
  response = requests.get(
      f'https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/{customer_id}',
      headers={
          'x-api-key': 'your_api_key_here'
      }
  )

  customer = response.json()
  ```
</CodeGroup>

### Response

<CodeGroup>
  ```json Success theme={null}
  {
    "id": "cust_a1b2c3d4e5f6",
    "organizationId": "org_123456",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "address": "123 Main St, City, State 12345",
    "devices": ["device_001", "device_002"],
    "orders": ["order_001", "order_002"],
    "metadata": {},
    "createdAt": "2025-10-01T12:00:00Z"
  }
  ```

  ```json Error - Not Found theme={null}
  {
    "error": "Customer not found"
  }
  ```

  ```json Error - Missing ID theme={null}
  {
    "error": "Customer ID is required"
  }
  ```
</CodeGroup>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
    -H "x-api-key: your_api_key_here"
  ```

  ```javascript JavaScript theme={null}
  const customerId = 'cust_a1b2c3d4e5f6';
  const response = await fetch(
    `https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/${customerId}`,
    {
      method: 'GET',
      headers: {
        'x-api-key': 'your_api_key_here'
      }
    }
  );

  const customer = await response.json();
  ```

  ```python Python theme={null}
  import requests

  customer_id = 'cust_a1b2c3d4e5f6'
  response = requests.get(
      f'https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/{customer_id}',
      headers={
          'x-api-key': 'your_api_key_here'
      }
  )

  customer = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "id": "cust_a1b2c3d4e5f6",
    "organizationId": "org_123456",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "address": "123 Main St, City, State 12345",
    "devices": ["device_001", "device_002"],
    "orders": ["order_001", "order_002"],
    "metadata": {},
    "createdAt": "2025-10-01T12:00:00Z"
  }
  ```

  ```json Error - Not Found theme={null}
  {
    "error": "Customer not found"
  }
  ```

  ```json Error - Missing ID theme={null}
  {
    "error": "Customer ID is required"
  }
  ```
</ResponseExample>

## Status Codes

| Code | Description                                               |
| ---- | --------------------------------------------------------- |
| 200  | Customer found and returned successfully                  |
| 400  | Invalid request (missing or invalid customer ID)          |
| 401  | Invalid or missing API key                                |
| 404  | Customer not found or doesn't belong to your organization |
| 500  | Internal server error                                     |

## Notes

* Returns only customers in your organization
* Customer ID must be valid UUID
* Use [Query by Email](/api-reference/customer/query) if you don't have the ID