diff --git a/doc/specification/api.v1.raml b/doc/specification/api.v1.raml
new file mode 100644
index 0000000..44bd043
--- /dev/null
+++ b/doc/specification/api.v1.raml
@@ -0,0 +1,23 @@
+#%RAML 0.8
+  ---
+  title: YouYesYet API
+  baseUri: https://api.yyy.scot/{version}
+  version: v1
+
+
+/canvassers:
+  get:
+  put:
+
+/electors:
+  get:
+  /{id}:
+  get:
+  /{address_id}:
+  get:
+
+# Location isn't a real entity in the database, but it is a means of searching for
+# addresses and electors.
+/location:
+  /{lat}/{long}/{radius}:
+    get: