Add public country search API backed by country_reference

2026-02-07 16:47:11 +05:30
parent 71c10193a3
commit c39188d453
5 changed files with 160 additions and 0 deletions
--- a/docs/API_REFERENCE.txt
+++ b/docs/API_REFERENCE.txt
@@ -148,6 +148,32 @@ AUTH + SYSTEM APIS
  - 400 Bad Request (q too short)
  - 401 Unauthorized

+
+- Country search API is this one:
+
+  GET /geo/countries/search
+
+  What it does:
+
+  - Searches countries from local country_reference table.
+  - Case-insensitive match on country name, official name, ISO alpha-2, and ISO alpha-3.
+  - Example: q=IND returns matches like India and related country names.
+
+  Request body:
+
+  - None.
+
+  Query params:
+
+  - q (required, minimum 3 characters)
+  - limit (optional, default 20, min 1, max 100)
+
+  - Allowed roles: Public endpoint.
+
+  Error Codes
+
+  - 400 Bad Request (q too short)
+
 ================================================================================
 PROPERTY + USER APIS
 ================================================================================