{"openapi":"3.1.0","info":{"title":"Rainbowpages API","version":"1.0.0","description":"Public API of Rainbowpages — Sri Lanka's national business directory. Search businesses by name, category and location; read listings, categories and districts. Read endpoints need no authentication. AI agents can also connect over MCP (Streamable HTTP) at https://directorybackend.ideus.lk/mcp."},"servers":[{"url":"https://directorybackend.ideus.lk"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/api/v1/auth/register":{"post":{"summary":"Create an account (sends an email code)","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":8,"maxLength":128},"phone":{"type":"string","maxLength":20}},"required":["name","email","password"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/verify-email":{"post":{"summary":"Confirm email with the 6-digit code and sign in","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"code":{"type":"string","minLength":6,"maxLength":6},"client":{"default":"web","type":"string","enum":["web","app"]}},"required":["email","code"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/resend-code":{"post":{"summary":"Send a new email verification code","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/login":{"post":{"summary":"Sign in with email and password","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":1},"client":{"default":"web","type":"string","enum":["web","app"]}},"required":["email","password"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/refresh":{"post":{"summary":"Exchange a refresh token for new tokens (rotates)","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"refreshToken":{"type":"string","minLength":20}},"required":["refreshToken"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/logout":{"post":{"summary":"Revoke a refresh token","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"refreshToken":{"type":"string","minLength":20}},"required":["refreshToken"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/me":{"get":{"summary":"Current user","tags":["Auth"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/forgot-password":{"post":{"summary":"Email a password reset code","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/reset-password":{"post":{"summary":"Set a new password using the emailed code","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"code":{"type":"string","minLength":6,"maxLength":6},"password":{"type":"string","minLength":8,"maxLength":128}},"required":["email","code","password"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/phone/send-code":{"post":{"summary":"Text a verification code to a Sri Lankan mobile","tags":["Auth"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"phone":{"type":"string","minLength":9,"maxLength":20}},"required":["phone"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/phone/verify":{"post":{"summary":"Confirm the SMS code","tags":["Auth"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"string","minLength":6,"maxLength":6}},"required":["code"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/google":{"get":{"summary":"Start Google sign-in (browser redirect). ?client=web|app&next=/path","tags":["Auth"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/auth/google/token":{"post":{"summary":"Sign in with a Google ID token (native mobile sign-in)","tags":["Auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"idToken":{"type":"string","minLength":20},"client":{"default":"web","type":"string","enum":["web","app"]}},"required":["idToken"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/categories":{"get":{"summary":"All categories with subcategories and listing counts","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/categories/{slug}":{"get":{"summary":"One top-level category (or /:slug/:sub for a subcategory)","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/locations":{"get":{"summary":"Districts with their cities","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses":{"get":{"summary":"Search published businesses","tags":["Directory"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Free text — business name, product or service","type":"string","maxLength":120}},{"name":"category","in":"query","required":false,"schema":{"description":"Category or subcategory slug","type":"string","maxLength":120}},{"name":"district","in":"query","required":false,"schema":{"description":"District slug, e.g. colombo","type":"string","maxLength":80}},{"name":"city","in":"query","required":false,"schema":{"description":"City slug, e.g. nugegoda","type":"string","maxLength":80}},{"name":"verified","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"near","in":"query","required":false,"schema":{"description":"Closest first from this point, e.g. 6.9271,79.8612","type":"string","pattern":"^-?\\d{1,2}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$"}},{"name":"radiusKm","in":"query","required":false,"schema":{"default":25,"description":"How far to look with near","type":"number","minimum":1,"maximum":100}},{"name":"sort","in":"query","required":false,"schema":{"default":"relevance","type":"string","enum":["relevance","rating","newest","name","recent","popular"]}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":500}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/featured":{"get":{"summary":"Premium and top-rated listings for home screens","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}":{"get":{"summary":"Full listing: contact, hours, photos, reviews, nearby","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/saved":{"get":{"summary":"Businesses you saved","tags":["Account"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/saved/{slug}":{"put":{"summary":"Save a business","tags":["Account"],"security":[{"bearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}},"delete":{"summary":"Remove a saved business","tags":["Account"],"security":[{"bearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/suggest":{"get":{"summary":"Type-ahead suggestions: categories, places and businesses","tags":["Directory"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/stats":{"get":{"summary":"Directory totals","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/reviews":{"post":{"summary":"Write or update your review of a business","tags":["Reviews"],"security":[{"bearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":5},"title":{"type":"string","maxLength":160},"body":{"type":"string","minLength":10,"maxLength":3000}},"required":["rating","body"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/enquiries":{"post":{"summary":"Send a message to a business (they get email + SMS)","tags":["Enquiries"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"phone":{"type":"string","maxLength":20},"email":{"anyOf":[{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]},"message":{"type":"string","minLength":10,"maxLength":2000}},"required":["name","message"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/claim":{"post":{"summary":"Start claiming a listing (SMS code to its number, or manual review)","tags":["Merchant"],"security":[{"bearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me":{"patch":{"summary":"Update your name","tags":["Account"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/push-token":{"post":{"summary":"Register this device for push notifications","tags":["Account"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"token":{"type":"string","pattern":"^Expo(nent)?PushToken\\[[^\\]]{10,150}\\]$"},"platform":{"type":"string","enum":["ios","android"]}},"required":["token","platform"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}},"delete":{"summary":"Stop push notifications on this device","tags":["Account"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/businesses":{"get":{"summary":"Businesses you manage","tags":["Merchant"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}},"post":{"summary":"Add a new business (reviewed before publishing)","tags":["Merchant"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":191},"categoryId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"tagline":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"keywords":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"phone":{"type":"string","maxLength":20},"phoneAlt":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}]},"whatsapp":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}]},"email":{"anyOf":[{"anyOf":[{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]},{"type":"null"}]},"website":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"addressLine":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"cityId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"postalCode":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}]},"lat":{"anyOf":[{"type":"number","minimum":5.8,"maximum":9.9},{"type":"null"}]},"lng":{"anyOf":[{"type":"number","minimum":79.4,"maximum":82},{"type":"null"}]},"openingHours":{"anyOf":[{"type":"object","properties":{"mon":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"tue":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"wed":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"thu":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"fri":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"sat":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"sun":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}}}},{"type":"null"}]},"social":{"anyOf":[{"type":"object","propertyNames":{"type":"string","enum":["facebook","instagram","tiktok","youtube","linkedin","x"]},"additionalProperties":{"type":"string","maxLength":255,"format":"uri"},"required":["facebook","instagram","tiktok","youtube","linkedin","x"]},{"type":"null"}]},"establishedYear":{"anyOf":[{"type":"integer","minimum":1800,"maximum":2100},{"type":"null"}]},"languages":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},"required":["name","categoryId","phone","cityId"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/businesses/{id}":{"patch":{"summary":"Update a business you manage","tags":["Merchant"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":191},"categoryId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"tagline":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"keywords":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"phone":{"type":"string","maxLength":20},"phoneAlt":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}]},"whatsapp":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}]},"email":{"anyOf":[{"anyOf":[{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]},{"type":"null"}]},"website":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"addressLine":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"cityId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"postalCode":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}]},"lat":{"anyOf":[{"type":"number","minimum":5.8,"maximum":9.9},{"type":"null"}]},"lng":{"anyOf":[{"type":"number","minimum":79.4,"maximum":82},{"type":"null"}]},"openingHours":{"anyOf":[{"type":"object","properties":{"mon":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"tue":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"wed":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"thu":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"fri":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"sat":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}},"sun":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","close"]}}}},{"type":"null"}]},"social":{"anyOf":[{"type":"object","propertyNames":{"type":"string","enum":["facebook","instagram","tiktok","youtube","linkedin","x"]},"additionalProperties":{"type":"string","maxLength":255,"format":"uri"},"required":["facebook","instagram","tiktok","youtube","linkedin","x"]},{"type":"null"}]},"establishedYear":{"anyOf":[{"type":"integer","minimum":1800,"maximum":2100},{"type":"null"}]},"languages":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/enquiries":{"get":{"summary":"Messages sent to your businesses","tags":["Merchant"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/plans":{"get":{"summary":"Monthly listing plans and ad spaces with prices for each period (LKR)","tags":["Billing"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/ads":{"get":{"summary":"Active sponsored placement for a page (one advertiser per spot)","tags":["Billing"],"parameters":[{"name":"placement","in":"query","required":true,"schema":{"type":"string","enum":["home_banner","category_top","promotions"]}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"district","in":"query","required":false,"schema":{"type":"string","maxLength":80}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/checkout/subscription":{"post":{"summary":"Start a monthly plan; returns PayHere form fields to POST","tags":["Billing"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"businessId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"plan":{"type":"string","minLength":1,"maxLength":32}},"required":["businessId","plan"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/ad-availability":{"get":{"summary":"When an ad space is next free for a category/district","tags":["Billing"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/checkout/ad":{"post":{"summary":"Book an ad space for two weeks, a month, three months or a year; returns PayHere form fields to POST","tags":["Billing"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slot":{"type":"string","minLength":1,"maxLength":32},"businessId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"categoryId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"districtId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"headline":{"type":"string","minLength":3,"maxLength":120},"targetUrl":{"anyOf":[{"type":"string","maxLength":255,"format":"uri"},{"type":"string","const":""}]},"period":{"default":"year","type":"string","enum":["two_weeks","month","quarter","year"]}},"required":["slot","businessId","headline"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/billing":{"get":{"summary":"Your plans, ad spaces and payments","tags":["Billing"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/orders/{orderId}":{"get":{"summary":"Status of a checkout (polled by the return page)","tags":["Billing"],"security":[{"bearer":[]}],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/subscriptions/{id}/cancel":{"post":{"summary":"Stop renewing a plan (it stays active until the paid month ends)","tags":["Billing"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/ads/{id}":{"patch":{"summary":"Change an ad headline or link (re-reviewed)","tags":["Billing"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"headline":{"type":"string","minLength":3,"maxLength":120},"targetUrl":{"anyOf":[{"type":"string","maxLength":255,"format":"uri"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/ads/{id}/image":{"post":{"summary":"Upload the ad picture (multipart field \"file\"; cropped to the size of the ad space)","tags":["Billing"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/booking":{"get":{"summary":"Whether a business takes online bookings, and its services","tags":["Bookings"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/booking/slots":{"get":{"summary":"Free start times for a service on a date (Asia/Colombo)","tags":["Bookings"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"service","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/bookings":{"post":{"summary":"Book a time. The customer and business get SMS confirmations.","tags":["Bookings"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"serviceId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"name":{"type":"string","minLength":2,"maxLength":120},"phone":{"type":"string","minLength":9,"maxLength":20},"email":{"anyOf":[{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]},"note":{"type":"string","maxLength":500}},"required":["serviceId","date","time","name","phone"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bookings/{token}":{"get":{"summary":"A booking, by the private link sent to the customer","tags":["Bookings"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/businesses/{id}/booking":{"get":{"summary":"Booking settings and services for your business","tags":["Bookings"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}},"put":{"summary":"Turn online booking on/off and set rules (Premium)","tags":["Bookings"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"enabled":{"type":"boolean"},"capacity":{"default":1,"type":"integer","minimum":1,"maximum":50},"slotMinutes":{"default":30,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"minNoticeHours":{"default":2,"type":"integer","minimum":0,"maximum":168},"maxDaysAhead":{"default":30,"type":"integer","minimum":1,"maximum":180},"autoConfirm":{"default":true,"type":"boolean"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},"required":["enabled"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/businesses/{id}/services":{"post":{"summary":"Add a bookable service","tags":["Bookings"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"durationMin":{"type":"integer","minimum":10,"maximum":600},"priceLkr":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000000},{"type":"null"}]},"active":{"type":"boolean"}},"required":["name","durationMin"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/bookings":{"get":{"summary":"Bookings across your businesses","tags":["Bookings"],"security":[{"bearer":[]}],"parameters":[{"name":"scope","in":"query","required":false,"schema":{"default":"upcoming","type":"string","enum":["upcoming","past"]}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/quotes":{"post":{"summary":"Get up to 3 quotes: sends your job to three matching local businesses by SMS/email","tags":["Quotes"],"security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"categoryId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"districtId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"cityId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"details":{"type":"string","minLength":20,"maxLength":2000},"whenNeeded":{"default":"flexible","type":"string","enum":["asap","this_week","this_month","flexible"]},"budget":{"type":"string","maxLength":60},"phone":{"type":"string","minLength":9,"maxLength":20}},"required":["categoryId","districtId","details","phone"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/quotes/{token}":{"get":{"summary":"Your quote request and the replies","tags":["Quotes"],"security":[{"bearer":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/leads":{"get":{"summary":"Quote requests sent to your businesses","tags":["Quotes"],"security":[{"bearer":[]}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/leads/{id}":{"patch":{"summary":"Reply to a quote request with a price, or decline","tags":["Quotes"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"quoted"},"quoteLkr":{"type":"integer","minimum":0,"maximum":100000000},"message":{"type":"string","minLength":5,"maxLength":2000}},"required":["status","message"]},{"type":"object","properties":{"status":{"type":"string","const":"declined"},"message":{"type":"string","maxLength":500}},"required":["status"]}]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/events":{"post":{"summary":"Count a listing view or contact tap (powers owner insights)","tags":["Analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":191},"type":{"type":"string","enum":["view","call","whatsapp","directions","website"]}},"required":["slug","type"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/me/businesses/{id}/insights":{"get":{"summary":"Views, calls, messages and bookings per day, with the previous period for comparison","tags":["Analytics"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"default":30,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/live/fx":{"get":{"summary":"Sri Lankan rupee exchange rates (mid-market, Rs per unit of each currency)","tags":["Live numbers"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/live/weather":{"get":{"summary":"Current weather and next-24-hour outlook for 23 Sri Lankan towns","tags":["Live numbers"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/live/weather/{town}":{"get":{"summary":"48-hour forecast for one town (id from /live/weather)","tags":["Live numbers"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/data/{key}":{"get":{"summary":"Public figures: fuel, inflation, tourist-arrivals or credit-ratings (updated automatically)","tags":["Live numbers"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bills/status":{"get":{"summary":"Whether bill payments (PayGo) are switched on","tags":["Bill payments"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bills/billers":{"get":{"summary":"Billers you can pay (electricity, water, mobile, telephone, TV, insurance, loans…), grouped","tags":["Bill payments"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bills/check":{"post":{"summary":"Look up an account: the customer's name and the amount due","tags":["Bill payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"billerId":{"type":"string","minLength":1,"maxLength":64},"accountNumber":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[A-Za-z0-9 /-]+$"}},"required":["billerId","accountNumber"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bills":{"post":{"summary":"Start a bill payment; returns the PayGo checkout URL","tags":["Bill payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"billerId":{"type":"string","minLength":1,"maxLength":64},"accountNumber":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[A-Za-z0-9 /-]+$"},"amount":{"type":"number","minimum":1,"maximum":5000000,"multipleOf":0.01},"email":{"anyOf":[{"type":"string","maxLength":190,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]},"phone":{"anyOf":[{"type":"string","maxLength":20},{"type":"string","const":""}]}},"required":["billerId","accountNumber","amount"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/bills/{ref}":{"get":{"summary":"A bill payment receipt and its status","tags":["Bill payments"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/offers":{"get":{"summary":"Offers running today, newest deadline first","tags":["Directory"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"district","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":500}},{"name":"limit","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":48}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/jobs":{"get":{"summary":"Open job vacancies","tags":["Directory"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"district","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":500}},{"name":"limit","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":48}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["full_time","part_time","contract","internship","temporary"]}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/jobs/{id}":{"get":{"summary":"One open job vacancy","tags":["Directory"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/sitemap/jobs":{"get":{"summary":"Open vacancy addresses for the sitemap","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/questions":{"post":{"summary":"Ask a business a public question","tags":["Reviews"],"security":[{"bearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string","minLength":10,"maxLength":500}},"required":["question"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/vcard":{"get":{"summary":"Download a business as a phone contact (vCard)","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/businesses/{slug}/report":{"post":{"summary":"Tell us a listing is wrong, closed or a scam","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reason":{"type":"string","enum":["wrong_details","closed","duplicate","scam","offensive","other"]},"details":{"type":"string","maxLength":1000},"email":{"anyOf":[{"type":"string","maxLength":191,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"string","const":""}]}},"required":["reason"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/reviews/{id}/photos":{"post":{"summary":"Add a photo to your review (multipart field \"file\")","tags":["Reviews"],"security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/tags":{"get":{"summary":"Popular product and service keywords","tags":["Directory"],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/tags/{slug}":{"get":{"summary":"One product or service keyword","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/articles":{"get":{"summary":"Published news and guides","tags":["Directory"],"parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["news","guide"]}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","si"]}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":500}},{"name":"limit","in":"query","required":false,"schema":{"default":12,"type":"integer","minimum":1,"maximum":30}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}},"/api/v1/articles/{slug}":{"get":{"summary":"One published article","tags":["Directory"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Validation error"},"401":{"description":"Unauthorised"}}}}}}