List reports
This code snippet shows you how to list all asynchronous report requests with the specified status. If required, you can also specify a date range.
Example
Key | Description |
---|---|
VONAGE_API_KEY |
Your Vonage API key (see it on your dashboard). |
VONAGE_API_SECRET |
Your Vonage API secret (also available on your dashboard). |
ACCOUNT_ID |
The account ID (same as VONAGE_API_KEY ) for the account you want to generate reports, or retrieve records for. |
REPORT_STATUS |
Status of report generation, can be any of PENDING , PROCESSING , SUCCESS , ABORTED , FAILED , TRUNCATED . For report listing, status is passed in as a comma-separated list of report status values. |
If you don't specify a date range, you receive the reports generated over the previous seven days.
Try it out
Set the replaceable variables. Parameter validity may vary with product.
Run the script and you receive a response similar to the following:
{
"self_link": "https://api.nexmo.com/v2/reports?account_id=abcd1234&status=SUCCESS",
"items_count": 17,
"reports": [
{
"request_id": "ri3p58f-48598ea7-1234-5678-90ab-faabd79abcde",
"request_status": "SUCCESS",
"direction": "outbound",
"product": "SMS",
"account_id": "abcd1234",
"date_start": "2020-05-21T13:27:00+0000",
"date_end": "2020-05-21T13:57:00+0000",
"include_subaccounts": false,
"status": "delivered",
"include_message": false,
"receive_time": "2020-06-03T15:24:31+0000",
"start_time": "2020-06-03T15:24:32+0000",
"_links": {
"self": {
"href": "https://api.nexmo.com/v2/reports/ri3p58f-48598ea7-1234-5678-90ab-faabd79abcde"
},
"download_report": {
"href": "https://api.nexmo.com/v3/media/e87a2d7c-abcd-1234-aa45-9bf17a1eb2a1"
}
},
"items_count": 4
},
...
]
}
Note the report request_id
is in the response. Also the file_id
, in this case e87a2d7c-abcd-1234-aa45-9bf17a1eb2a1
.