diff --git a/api-ref/src/docbkx/ch_telemetry-v2.xml b/api-ref/src/docbkx/ch_telemetry-v2.xml
index 9749f1238..60d135f68 100644
--- a/api-ref/src/docbkx/ch_telemetry-v2.xml
+++ b/api-ref/src/docbkx/ch_telemetry-v2.xml
@@ -285,4 +285,18 @@
+
+ Events
+ Lists all events and shows details for an event.
+
+
+
+
+
+
+
+
+
diff --git a/api-ref/src/wadls/telemetry-api/src/v2/common.ent b/api-ref/src/wadls/telemetry-api/src/v2/common.ent
index 4de1c5d9e..1def2fb65 100644
--- a/api-ref/src/wadls/telemetry-api/src/v2/common.ent
+++ b/api-ref/src/wadls/telemetry-api/src/v2/common.ent
@@ -684,3 +684,31 @@
GET /v2/meters/METER_NAME/statistics?aggregate.func=cardinality&aggregate.param=resource_id&aggregate.func=cardinality&aggregate.param=project_id
'>
+
+
+
+ Filters the response by one or more event arguments.
+
+
+ For example:
+
+GET /v2/events?q.field=Foo&q.value=my_text
+
+
+
+
+
+ Limits the maximum number of samples that are returned in the
+ response.
+
+
+ For example:
+
+GET /v2/events?limit=1000
+
+'>
diff --git a/api-ref/src/wadls/telemetry-api/src/v2/os-telemetry-api-2.0.wadl b/api-ref/src/wadls/telemetry-api/src/v2/os-telemetry-api-2.0.wadl
index 9af20fcd9..3f6c98070 100644
--- a/api-ref/src/wadls/telemetry-api/src/v2/os-telemetry-api-2.0.wadl
+++ b/api-ref/src/wadls/telemetry-api/src/v2/os-telemetry-api-2.0.wadl
@@ -48,6 +48,21 @@
+
+
+
+
+
+
+ The ID of the message.
+
+
+
+
+
+
@@ -775,4 +790,42 @@
+
+
+
+ Lists all events.
+
+
+
+
+ &eventQueryParameter;
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Shows details for an event.
+
+
+
+
+
+
+
+
+
+
+
diff --git a/api-ref/src/wadls/telemetry-api/src/v2/samples/list_event.json b/api-ref/src/wadls/telemetry-api/src/v2/samples/list_event.json
new file mode 100644
index 000000000..4bd2dafd8
--- /dev/null
+++ b/api-ref/src/wadls/telemetry-api/src/v2/samples/list_event.json
@@ -0,0 +1,20 @@
+[
+ {
+ "raw": {},
+ "traits": [
+ {
+ "type": "string",
+ "name": "action",
+ "value": "read"
+ },
+ {
+ "type": "string",
+ "name": "eventTime",
+ "value": "2015-10-28T20:26:58.545477+0000"
+ }
+ ],
+ "generated": "2015-10-28T20:26:58.546933",
+ "message_id": "bae43de6-e9fa-44ad-8c15-40a852584444",
+ "event_type": "http.request"
+ }
+]
diff --git a/api-ref/src/wadls/telemetry-api/src/v2/samples/show_event.json b/api-ref/src/wadls/telemetry-api/src/v2/samples/show_event.json
new file mode 100644
index 000000000..5c736a074
--- /dev/null
+++ b/api-ref/src/wadls/telemetry-api/src/v2/samples/show_event.json
@@ -0,0 +1,18 @@
+{
+ "raw": {},
+ "traits": [
+ {
+ "type": "string",
+ "name": "action",
+ "value": "read"
+ },
+ {
+ "type": "string",
+ "name": "eventTime",
+ "value": "2015-10-28T20:26:58.545477+0000"
+ }
+ ],
+ "generated": "2015-10-28T20:26:58.546933",
+ "message_id": "bae43de6-e9fa-44ad-8c15-40a852584444",
+ "event_type": "http.request"
+}