Monitor Your Applications with the Audit API & Python

Monitor Your Applications with the Nexmo Audit Events API and Python

Published October 09, 2018 by Tony Bedford

In this blog post you’ll see how to create a web application in Python that allows you to view Nexmo audit events. Within Nexmo this monitoring of accounts is achieved through the Audit API.

Some reasons for using the Nexmo Audit API include:

  • Monitoring possible fraudulent access to accounts.
  • Compliance including SOX, SSAE16/SOC, ISO27001 and others.
  • Monitoring to help meet service level agreements.

Nexmo Audit Events API

Nexmo provides the Audit API for analyzing events that occur within a Nexmo account. The API allows you to easily:

  • Retrieve a list of all supported event types.
  • Obtain filtered lists of events (you can filter on one or more event type and use text search).
  • Retrieve details of a specific audit event.

In this blog post you will see how to:

  1. Retrieve supported event types.
  2. Obtain a list filtered on one event type.
  3. Obtain a list of all events.

You can review the Nexmo Audit API documentation for additional functionality, for example you can:

  • Retrieve audit events between a date range.
  • Retrieve audit events based on text search.
  • Combine various filters to obtain a very specific list of events.

This blog post only provides an introduction to using the Nexmo Audit API with Python.

The Nexmo Audit Events API is currently Beta. Currently, there is no support available in client libraries.

REST API Endpoints

The main REST API endpoint is:

You can obtain a list of all audit events using a GET. You can also obtain a list of supported event types by using OPTIONS on the endpoint.

Audit event requests can be filtered using query parameters. For example:

EVENT_TYPE can be a comma-delimited list of event types, for example:

Simple Web Application

The web application in this blog post has been deliberately kept very simple, so you can focus on the key Nexmo Audit API calls you need to make to obtain a list of audit events.

There’s a simple form containing a drop-down list populated with the supported event types. You can chose a specific event type from the list or select ALL for all event types. You then click the form button to select your choice. A table containing the list of recorded events is returned and displayed.

The Python web application here has two prerequisites:

  1. Requests – provides an easy way to make REST API calls.
  2. Flask – provides a web application framework.

Installation instructions for these two libraries can be found on their web sites, but can be easily installed with pip.

The application presented here was only tested with Python 3.

The Python web application source code:

For test purposes you can run the web application locally.

To test out the web app:

  1. Navigate your browser to http://localhost:3000.
  2. You can select a specific event type to view from the drop-down list, or select ALL from the drop-down list to view all events.
  3. Click Submit to receive a list of events.

Source Code

The latest source code for the example web application is hosted at Nexmo Community on GitHub.


In this blog post you’ve seen how to create a simple Python web application that allows you to retrieve a list of audit events from your Nexmo account. Using this web app you can monitor your account for suspicious behaviour, or for potential issues.

Further Reading

You can find out more about the Nexmo Audit Event API from the following resources:

Leave a Reply

Your email address will not be published.

Get the latest posts from Nexmo’s next-generation communications blog delivered to your inbox.

By signing up to our communications blog, you accept our privacy policy , which sets out how we use your data and the rights you have in respect of your data. You can opt out of receiving our updates by clicking the unsubscribe link in the email or by emailing us at [email protected].