Check report status

Once a report has been requested, it may take some time to generate. You can check on the progress of your report by calling the GET /v2/reports/:id endpoint, for example:


Replace REQUEST_ID with the request_id returned by the initial call to the create report endpoint.

In addition to polling for the report's status, you can register a webhook that Vonage's APIs will make a request to when the report has been generated. To do this, specify a callback_url parameter when creating the report.

The response will contain information about the report. The download_report field only becomes visible when the report generation is completed. You can use it to retrieve the report, as will be shown in the next step.

  "request_id": "6c5506b7-f16a-44dc-af06-756bbf467488",
  "request_status": "SUCCESS",
  "product": "SMS",
  "account_id": "$API_KEY",
  "date_start": "2019-02-27T00:00:00+0000",
  "date_end": "2019-02-28T23:59:59+0000",
  "include_subaccounts": false,
  "direction": "outbound",
  "include_message": false,
  "receive_time": "2019-06-17T16:39:06+0000",
  "start_time": "2019-06-17T16:39:06+0000",
  "_links": {
    "self": {
      "href": ""
    "download_report": {
      "href": ""
  "items_count": 14952

Create a CSV report using the command line

Create a CSV report using the command line tool, curl.