Understanding Timezone Information in API Data Exports
When you export chat data or retrieve information through the LiveAgent API, the timestamps in the returned data are displayed in your account's configured timezone. This article explains how to identify your account's timezone and work with API timestamps.
Timezone in API Responses
All data retrieved through the LiveAgent API is automatically displayed in the timezone that is configured for your account. This means that if your account is set to Eastern Standard Time (EST), all timestamps in API responses will reflect EST, not UTC or any other timezone.
How to Find Your Account's Timezone
To determine what timezone your account is using, follow these steps:
- Use the LiveAgent API v3 endpoint: GET /settings
- This endpoint will return your account settings, including the configured timezone
- Review the timezone value in the response to understand how your API data timestamps are being displayed
GET /settings
Working with Timezone-Adjusted Data
If you need to work with timestamps in a different timezone or convert between timezones, LiveAgent provides tools to help with timezone offset calculations. For detailed information on how to utilize timezone offsets to shift the dates and times of your API results, refer to the article on Utilizing time zone offset to shift the dates and times of API results.
Key Points to Remember
- API data timestamps are always in your account's configured timezone
- Use the GET /settings API endpoint to retrieve your account's timezone setting
- If you need timestamps in a different timezone, you can apply timezone offset calculations to convert them
- This applies to all data exports and API queries, including historical chat data
Related Resources
For more information on working with timezones in API results, see the article on utilizing timezone offsets to adjust date and time values returned by the API.