REST API
Plain HTTP access to the connector, for testing with `curl` or clients without MCP.
The REST routes call the same services as the MCP server, so the results are
the same. Use them to test with curl or from a client without MCP support.
- Base URL:
https://api.relmo.co - Auth:
Authorization: Bearer <connector key>. See Authentication.
Filters are flat query parameters. Array values (localities, bhk, amenities,
sales_status, construction_status) are comma-separated. The names and meanings match the
search filters, plus sort (default recommended) and page
(default 1) on search.
Response bodies are the same JSON the matching MCP tool returns. See each tool for an example.
Endpoints
| Method | Path | MCP tool |
|---|---|---|
GET | /v1/listings/suggest | suggest |
GET | /v1/listings/stats | market_stats |
GET | /v1/listings | search_listings |
GET | /v1/listings/{slug} | get_listing |
POST | /v1/listings/enquiries | create_enquiry |
Examples
Resolve a name:
curl -H "Authorization: Bearer $RELMO_CONNECTOR_KEY" \
"https://api.relmo.co/v1/listings/suggest?q=Andheri%20West"Search 2 and 3 BHK homes up to ₹2 crore:
curl -H "Authorization: Bearer $RELMO_CONNECTOR_KEY" \
"https://api.relmo.co/v1/listings?city=mumbai&bhk=2,3&price_max=20000000&sort=price_asc"Request a callback:
curl -X POST https://api.relmo.co/v1/listings/enquiries \
-H "Authorization: Bearer $RELMO_CONNECTOR_KEY" \
-H "Content-Type: application/json" \
-d '{
"project_id": "<id from a search result>",
"action": "request_callback",
"name": "Asha Rao",
"phone": "+919800000000",
"platform": "my-agent",
"submission_id": "3f1c1f62-6f3a-4a52-9f0e-2c1f8a9d7b11"
}'Responses
| Status | Meaning |
|---|---|
200 | Success |
201 | Enquiry captured. Body: { "captured": true, "leadId": "..." } |
202 | Enquiry received but not captured as a buyer lead: { "captured": false, "leadId": null } |
400 | Invalid filter or body, including a submission_id that isn't a UUID |
401 | Missing or invalid connector key |
404 | Unknown or unpublished listing slug, or unknown project_id on an enquiry |
429 | Rate limit exceeded |