You own 1 to 30 units and manage them yourself. You deal directly with tenants, contractors, and service providers. Your Nana account is your management system — every document tied to your WhatsApp number.
Tenancy agreements, rent receipts, deposit protection, service contracts. All in one place. All on your phone.
You manage properties on behalf of multiple landlords. You collect rent, disburse to owners, manage service contracts, and handle tenant relations. Nana documents every layer of that relationship — your mandate from the owner, the disbursements, the service contracts.
The landlord gets a verified record of every shilling collected and disbursed on their behalf.
// Create a locked document in 3 API calls // 1. Create the document const doc = await fetch('https://api.asknana.co.ke/api/document/create', { method: 'POST', headers: { 'Authorization': 'Bearer nana_live_xxxx' }, body: JSON.stringify({ doc_type: 'invoice', creator_phone: '+254712345678', counterparty_phone: '+254722987654', items: [{ name: 'Service fee', quantity: 1, unit_price: 15000 }] }) }); // Returns: { doc_id, nana_ref: 'NANA-2026-0048', status: 'draft' } // 2. Send OTP to counterparty await fetch('https://api.asknana.co.ke/api/document/send-otp', { ... }); // 3. Verify OTP — document locks automatically const result = await fetch('https://api.asknana.co.ke/api/document/verify-otp', { ... }); // Returns: { verified: true, verify_url, sha256_hash, locked_at }
| Method | Endpoint | What it does |
|---|---|---|
| POST | /api/user/create | Register a new user. Returns nana_ref and plan tier. |
| POST | /api/document/create | Create a new document in DRAFT status. Returns doc_id and preview. |
| POST | /api/document/send-otp | Generate and deliver OTP to the counterparty's WhatsApp. |
| POST | /api/document/verify-otp | Verify OTP. Document locks automatically on success. Returns hash. |
| GET | /api/verify/:doc_id | Public verification endpoint. No auth required. Returns document status and hash. |
| GET | /api/document/:id/pdf | Generate and return the locked document as an A4 PDF. |
| POST | /api/dispute/create | File a dispute on a locked document. Both parties notified. |
| GET | /api/user/:id/trade-statement | Return verified trade history. Used for credit scoring integration. |
Nana does not share user data without explicit, informed user consent. No institution accesses a user's trade history unless that user has actively granted access — through Nana's consent flow, on their own WhatsApp, in their own time.
The consent is specific — the user chooses which institution, what data, and for how long. It can be revoked at any time. This is not opt-out data sharing. It is opt-in, user-controlled, consent-based access.
Data shared includes: verified transaction volume, document types, completion rate, counterparty count, payment history on instalment agreements. It does not include document contents, counterparty identities, or personal communications.