Skip to main content
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"

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

​
Overview

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

​
Authentication

​
x-api-key
string
required
Your organization’s API key

​
Path Parameters

​
telemetronCustomerId
string
required
The unique customer identifier

​
Response

​
id
string
The unique customer identifier (telemetronCustomerId)
​
organizationId
string
The organization ID this customer belongs to
​
name
string
Customer’s full name
​
email
string
Customer’s email address
​
phone
string
Customer’s phone number (if provided)
​
address
string
Customer’s address (if provided)
​
devices
array
Array of device identifiers assigned to this customer
​
orders
array
Array of order identifiers associated with this customer
​
metadata
object
Additional customer metadata
​
createdAt
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"

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

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

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

​
Status Codes

CodeDescription
200Customer found and returned successfully
400Invalid request (missing or invalid customer ID)
401Invalid or missing API key
404Customer not found or doesn’t belong to your organization
500Internal 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