diff --git a/issues.md b/issues.md
new file mode 100644
index 0000000..140404a
--- /dev/null
+++ b/issues.md
@@ -0,0 +1,51 @@
+# Issue #138 — Practical API examples
+
+Status: Completed
+
+## Description
+
+Create practical examples demonstrating common API workflows.
+
+## Tasks
+- Add request examples.
+- Add response examples.
+- Cover authentication flows.
+- Include troubleshooting tips.
+
+## Acceptance Criteria
+- Examples are functional.
+- Common workflows are documented.
+- Contributors can test endpoints easily.
+
+## Resolution
+Implemented in `listener/API.md` with request and response examples, authentication flow documentation, and troubleshooting guidance.
+
+---
+
+# Issue #183 — Comprehensive API reference guide
+
+Status: Completed
+
+## Description
+
+Developers integrating with NotifyChain need a single source of truth for API endpoints, request payloads, response structures, and smart contract events.
+
+Create a comprehensive reference guide to improve developer onboarding and integration speed.
+
+## Tasks
+- Document all public API endpoints.
+- Document request and response schemas.
+- Document emitted contract events.
+- Include example requests and responses.
+- Add authentication requirements.
+- Add versioning guidelines.
+
+## Acceptance Criteria
+- Developers can integrate without reviewing source code.
+- Event payloads are documented accurately.
+- Examples are tested and verified.
+- Documentation remains synchronized with current APIs.
+
+## Resolution
+Implemented in `listener/API.md` and related documentation, and this file now reflects the completed status for both issue entries.
+