My tickets
 
Submit ticket
 
Login
 
API v3
Home
>
Technical Support
>
LiveAgent API
>
REST API
>
API v3
Documentation
Where can I find the API v3 documentation? You can find whole LiveAgent API documentation within your LiveAgent account: https://YOURDOMAIN.ladesk.com/docs/api/v3/#/ You can also navigate into your agent panel > Configuration > System > API > API V3 DOCUMENTATION How can I try LiveAgent API v3 with my account? Within the documentation, you can find examples and use the possibility to test the API commands with your account. - Consider registering a new free Trial a...
Filtering API v3 results
With API v3 you have an option to use filters to get specific results. Filters for the GET /tickets API to retrieve a list of tickets are especially limited, for more details and all available options please [see this article](https://support.liveagent.com/870644-Filtering-API-v3-GET-tickets-results). Simple filters Using a simple filterm you can filter results by searching for a specific column with an exact value: {"parameter":"value"} This simple filter allows you to retrieve e.g. ticket...
Filtering API v3 GET /tickets results
To filter the retrieved list of tickets it is possible to use only the filters which are available in the agent panel. Some filters, e.g. {"subject":"order"} work slightly differently than expected. Instead of searching for "subject equals order" it searches for "subject contains order", so it would find all tickets containing the word "order" in subject, e.g. tickets with the subject "Order #123", "Order #456", or even "Order-inquiry". It is also possible to use the search parameter to do a f...
Utilizing time zone offset to shift the dates & times of API results
When using LiveAgent, the dates and times displayed in the panel are automatically recalculated according to the user's PC time zone. However, API v3 returns data according to the time zone of your LiveAgent account. This can lead to discrepancies when, for example, searching for tickets in the panel and retrieving ticket lists via API. To align the dates and times with your preferred timezone, you need to add a Timezone-Offset header to your API calls. This will adjust the time of the retrieved...
How to work with _cursor parameter
Some API requests that contain the _perPage parameter don't have the _page parameter to display the next page. Instead of the _page parameter you'd need to use the _cursor parameter to display the next page with records. List of requests utilizing the _cursor parameter - GET /calls - GET /grid/reports/time - GET /phone_numbers - GET /tickets/history The value for the _cursor parameter is provided to you in the response header as the next_page_cursor header value. So essentiall...
Swagger API descriptor
If you need to generate LiveAgent's API library / SDK for your preferred programming language (like for example C#) you can use the swagger (OpenAPI) API descriptor which can be found at the very top of the API v3 documentation (https://support.liveagent.com/567924-Documentation--examples).
Examples
Export tickets to CSV
Subcategories
Examples