diff --git a/README.md b/README.md
new file mode 100644
index 0000000..df043d2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# dd-api-oper
+## Inleiding
+
+Rijkswaterstaat maakt gebruik van de [Operationele Digitale Delta API]
+(https://digitaledeltaorg.github.io/dd-oper.v201.html). Deze api word
+gebruikt voor het opvragen van:
+
+ * Metingen
+ * Verwachtingen
+ * Astronomisch getij
+
+De digitale delta api is beschikbaar via:
+
+ *  https://ddapi.rws.nl/dd-oper/2.0
+
+De authenticatie op deze url is geregeld via PKI overheidscertificaten.
+Zonder PKI overheidscertificaat is de api niet toegankelijk.
+
+Deze git repository bevat een python module om de dd-api te benaderen
+inclusief:
+
+ * Autenticatie via certificaten.
+ * Access functies voor de resultaten.
+
+## De inhoud van de git repository
+
+ * ddapioper.py: Python module
+ * test-ddapi: Een klein voorbeeld en test programma voor de module
+ * DD-API-Oper demo.ipynb: Een [Jupyter notebook](met een demo).
+
+### ddapioper.py
+
+Deze module bevat documentatie. Deze is op te vragen door de module te
+laden en vervolgens via de python hulp functie heb je toegang tot de
+documentatie.
+
+### test-ddapi
+
+Een werkend voorbeeld en test programma voor de api.
+
+Wel moeten de paden van het certificaat en de bijbehorende private key
+nog ingevuld worden. Er staat twee keer "<TODO>" in de code.
+
+### DD-API-Oper demo.ipynb
+
+Een werende demo in Jupyter van de dd-api en de module.
+
+In deze demo worden de volgende elementen getoont:
+
+ * Het opvragen van de lijst met locaties.
+   * De gegevens van een locatie.
+ * Het opvragen van de quantities.
+   * Inclusief de quantities van een specefieke locatie.
+ * Het opvragen van waarde.
+   * Het opvragen diverse meta data gegevens.
+   * Het verder verwerken van meetgegevens.
+   * De meetgegevens in rmi sip formaat weergeven.
+   * Het plotten van meetgegevens in een grafiek 
+
+## Over de certificaten.
+
+Om de api te kunnen gebruiken is een pki overheidscertificaat en de
+bijbehorende private key nodig. Het certicaat moet geldig zijn als
+client certificaat.
+
+Het certificaat moet aangeboden worden in x509 formaat en de private
+key mag niet encrypt zijn.
+
+## Status
+
+Deze module en de voorbeeld code is in ontwikkeling. Dit is geen
+stabiele code!
+
+## Vragen en/of uitbreidingen.
+
+Vragen en of uitbreidingen kunnen gemaild worden naar [ddapioper@marceln.org]