diff --git a/README.md b/README.md
index 884099364110468c0906187e4c5ce2913bb43100..5e46a4556fc553d986b2446cf4b3f191c22c3e35 100644
--- a/README.md
+++ b/README.md
@@ -6,3 +6,15 @@ This is the MIP implementation.
 
 Run `mvn clean`, `mvn package` and `java -jar target/*.jar` to compile and run a demo.
 To use it, you need to configure some URLs and register an openid client on the HBP platform.
+
+## API Documentation using Swagger (Springfox)
+
+The API documentation is available at `<BASE URL>/swagger-ui.html`. A JSON version is available at `<BASE URL>/v2/api-docs`
+
+## TODO
+
+* Implement a script to populate the DB for testing purpose;
+* Clean swagger annotations;
+* Implementation missing API features (updates, deletes, special parameters);
+* Implement logout;
+* Adapt frontend (add introduction page, hide header/footer when not logged in).