Parrot Realty
Platform API
Backend for the marketplace website, CRM dashboard and field app. Staff endpoints currently need Authorization: Bearer $INTERNAL_API_TOKEN until staff login is added.
| GET | /api/v1/locations/search?q=bath | Typed location suggestions (public) |
| GET | /api/v1/locations/pincode/670721 | Pincode → district, taluk, panchayath, villages, tags (public) |
| POST | /api/v1/public/enquiries | Website enquiry → customer + lead (public) |
| GET / POST | /api/v1/properties | List / create properties, auto-tagged by pincode (staff) |
| POST | /api/v1/uploads/presign | Presigned R2 upload URLs for photos, videos, documents (staff) |
| POST | /api/v1/uploads/complete | Confirm uploads, set cover photo (staff) |
| GET | /api/v1/media/:id/url | View URL; signed 5-minute link for private files (staff) |
| GET | /api/v1/leads | Lead queue (staff) |
| GET / POST | /api/v1/deals | Deal pipeline with stage counts + totals / create deal (staff) |
| POST | /api/v1/deals/:id/stage | Move stage; Lost needs a reason (staff) |
| POST | /api/v1/deals/:id/locker | Activate Parrot Locker Key for a Won deal (staff) |
| POST | /api/v1/locker-documents/:id/share | Share a document with the customer (staff) |
| POST | /api/v1/portal/invite/accept | Customer sets password from invitation |
| POST / GET | /api/webhooks/voxbay?token=… | Voxbay call events → calls, customers, leads, call-back tasks |