Retrieve a customer

View as Markdown
Return one stored record in data by its identifier. This operation does not accept a date range. Full stored analysis and transcription are returned without an include selector. The record contains the current customer_analytics, meta_analytics and native timeline object. It preserves the customer portion of the analytics webhook; it does not reconstruct a historical profile. For larger datasets, use [Create export](/v0/api-reference/exports/create-export) to obtain a CSV download link. Each export supports at most 31 days, 100,000 records and 100 MB; split longer periods into adjacent windows.

Authentication

AuthorizationBearer
Existing private account API key from Developer Hub. Keep it on your backend.

Path parameters

customer_idstringRequired1-255 characters

Identifier returned by the corresponding list operation. Nonempty, at most 255 characters; whitespace-only values and control characters are rejected.

Query parameters

service_idstringRequired1-255 characters

Required authorized service. Client identity is derived from the API key. Nonempty, at most 255 characters; whitespace-only values and control characters are rejected.

Response

Successful response.
dataobject

Current stored customer profile and the native customer analytics/timeline from the analytics webhook. It is not a historical snapshot.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error