Get Customer by ID

GET

api

ext-v1

customer

getCustomer

{telemetronCustomerId}

curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
  -H "x-api-key: your_api_key_here"

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();

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()

{
  "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"
}

{
  "error": "Customer not found"
}

{
  "error": "Customer ID is required"
}

Overview

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

Authentication

string

required

Your organization’s API key

Path Parameters

string

required

The unique customer identifier

Response

string

The unique customer identifier (telemetronCustomerId)

string

The organization ID this customer belongs to

string

Customer’s full name

string

Customer’s email address

string

Customer’s phone number (if provided)

string

Customer’s address (if provided)

array

Array of device identifiers assigned to this customer

array

Array of order identifiers associated with this customer

object

Additional customer metadata

string

ISO 8601 timestamp of when the customer was created

Examples

Request

curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
  -H "x-api-key: your_api_key_here"

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();

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()

Response

{
  "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"
}

{
  "error": "Customer not found"
}

{
  "error": "Customer ID is required"
}

curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
  -H "x-api-key: your_api_key_here"

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();

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()

{
  "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"
}

{
  "error": "Customer not found"
}

{
  "error": "Customer ID is required"
}

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 if you don’t have the ID

curl -X GET https://admin.telemetron.ai/api/ext-v1/customer/getCustomer/cust_a1b2c3d4e5f6 \
  -H "x-api-key: your_api_key_here"

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();

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()

{
  "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"
}

{
  "error": "Customer not found"
}

{
  "error": "Customer ID is required"
}

API Reference

Customer Management

Device Management

Device Assignment

Ticket Management

Overview

Authentication

Path Parameters

Response

Examples

Request

Response

Status Codes

Notes

​Overview

​Authentication

​Path Parameters

​Response

​Examples

​Request

​Response

​Status Codes

​Notes

Overview

Authentication

Path Parameters

Response

Examples

Request

Response

Status Codes

Notes