Checking a Report Job Status


The Reporting API has been replaced by the Explore API. Talkdesk strongly encourages the transition to the Explore API. You may still use the Reporting API, but please note:

  • Talkdesk will only provide support (no SLA for bug fixing or outage recovery) until June 1, 2022.
  • The Reporting API endpoint will stop responding to requests on December 1, 2022.


Make a GETrequest to /reports/<report_type>/jobs/{id}

Sample Request

curl{id} \
-H 'Authorization: Bearer ACCESS_TOKEN' \


Job Status URL

The job ID can be retrieved, as well as the URL to check on its status, by using the response of the initial job request call.

Sample Response

If the report job has yet to be processed, the endpoint will return a 200 response.

  "id": "57add63204c799583700028e",
  "status": "processing",
  "timespan": {
    "from": "2016-07-29 00:00:00 UTC",
    "to": "2016-07-29 23:59:59 UTC"
  "_links": {
    "self": {
      "href": ""
    "files": {
      "href": ""

Once the report job is complete, the endpoint will return a 303 response, redirecting to the location of the report resource file. The location of the file will be provided in the location HTTP header:

The response body remains unchanged, except for the job status field getting updated to done.


If you have questions or technical issues, please open a ticket using this form.