From 5e46ee448a53be0e73d5bd081e7d812f604b8ccf Mon Sep 17 00:00:00 2001
From: galela <gsimon@woosmap.com>
Date: Fri, 2 Oct 2026 10:44:31 +0200
Subject: [PATCH 1/2] fix(stores): align response schemas and parameters with
 the API

---
 .../woosmap_http_parameters_storessearch.html |  34 ++--
 .../woosmap_http_parameters_storessearch.md   |  14 +-
 ...ap_http_parameters_storessearchbounds.html |  12 +-
 ...smap_http_parameters_storessearchbounds.md |   6 +-
 .../woosmap_http_parameters_zones.html        |   2 +-
 .../woosmap_http_parameters_zones.md          |   2 +-
 ...smap_http_schema_assetaddressresponse.html |  26 +--
 ...oosmap_http_schema_assetaddressresponse.md |  12 +-
 ...http_schema_assetautocompleteresponse.html |   2 +-
 ...p_http_schema_assetautocompleteresponse.md |   6 +-
 ...schema_assetfeaturecollectionresponse.html |   6 +-
 ...p_schema_assetfeaturecollectionresponse.md |  10 +-
 ...smap_http_schema_assetfeatureresponse.html |   6 +-
 ...oosmap_http_schema_assetfeatureresponse.md |  10 +-
 ...woosmap_http_schema_assetopenresponse.html |  87 ++++----
 .../woosmap_http_schema_assetopenresponse.md  |  14 +-
 .../woosmap_http_schema_assetresponse.html    | 162 ++++++++-------
 .../woosmap_http_schema_assetresponse.md      |  29 +--
 .../woosmap_http_schema_boundsresponse.html   |   6 +-
 .../woosmap_http_schema_boundsresponse.md     |   6 +-
 .../woosmap_http_schema_geojsonpoint.html     |   4 +-
 .../woosmap_http_schema_geojsonpoint.md       |   8 +-
 .../woosmap_http_schema_matchedsubstring.html |   8 +-
 .../woosmap_http_schema_matchedsubstring.md   |   8 +-
 .../woosmap_http_schema_pagination.html       |   4 +-
 .../schemas/woosmap_http_schema_pagination.md |   8 +-
 dist/woosmap-openapi3.json                    | 185 ++++++++++++++----
 dist/woosmap-openapi3.yml                     | 153 +++++++++++----
 specification/parameters/_index.yml           |   6 +-
 specification/parameters/search/bounds.yml    |   7 +
 specification/parameters/search/lat.yml       |   2 +-
 specification/parameters/search/limit.yml     |   1 +
 specification/parameters/search/lng.yml       |   2 +-
 specification/parameters/search/page.yml      |   2 +
 .../{encoded_polyline.yml => polyline.yml}    |   4 +-
 specification/parameters/search/radius.yml    |   2 +-
 .../parameters/search/stores_by_page.yml      |   1 +
 specification/parameters/zones/limit.yml      |   3 +-
 specification/parameters/zones/offset.yml     |   3 +-
 .../paths/search/storesAutocomplete.yml       |   1 +
 specification/paths/search/storesSearch.yml   |   3 +-
 .../schemas/AssetAddressResponse.yml          |  15 +-
 .../schemas/AssetAutocompleteResponse.yml     |   8 +
 .../AssetFeatureCollectionResponse.yml        |   4 +
 .../schemas/AssetFeatureResponse.yml          |   4 +
 specification/schemas/AssetOpenResponse.yml   |  17 +-
 specification/schemas/AssetResponse.yml       |  19 +-
 specification/schemas/BoundsResponse.yml      |   4 +-
 specification/schemas/GeoJsonPoint.yml        |   3 +
 specification/schemas/MatchedSubstring.yml    |   7 +-
 specification/schemas/Pagination.yml          |   3 +
 51 files changed, 629 insertions(+), 322 deletions(-)
 create mode 100644 specification/parameters/search/bounds.yml
 rename specification/parameters/search/{encoded_polyline.yml => polyline.yml} (79%)

diff --git a/dist/documentation/parameters/woosmap_http_parameters_storessearch.html b/dist/documentation/parameters/woosmap_http_parameters_storessearch.html
index 1244398d..a7e98e3f 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_storessearch.html
+++ b/dist/documentation/parameters/woosmap_http_parameters_storessearch.html
@@ -3,28 +3,36 @@
 <h2 id="optional-parameters">Optional parameters</h2>
 <ul>
   <li>
-    <h3 class="parameter-name" id="encoded_polyline">encoded_polyline</h3>
+    <h3 class="parameter-name" id="bounds">bounds</h3>
     <p>
-      Find assets nearby an
-      <a
-        href="https://developers.google.com/maps/documentation/utilities/polylinealgorithm"
-        >encoded polyline</a
-      >
-      and inside a defined radius.
+      Restricts the results to the Assets inside a bounding box, as
+      <code>west,south,east,north</code> in decimal degrees. Takes precedence
+      over <code>lat</code>/<code>lng</code> and <code>polyline</code>.
     </p>
   </li>
   <li>
     <h3 class="parameter-name" id="lat">lat</h3>
-    <p>Latitude bias for the results. Should be pass with <code>lng</code>.</p>
+    <p>Latitude bias for the results. Must be passed with <code>lng</code>.</p>
   </li>
   <li>
     <h3 class="parameter-name" id="lng">lng</h3>
-    <p>Longitude bias for the results. Should be pass with <code>lat</code>.</p>
+    <p>Longitude bias for the results. Must be passed with <code>lat</code>.</p>
   </li>
   <li>
     <h3 class="parameter-name" id="page">page</h3>
     <p>Page number when accessing paginated assets feature collection</p>
   </li>
+  <li>
+    <h3 class="parameter-name" id="polyline">polyline</h3>
+    <p>
+      Find assets nearby an
+      <a
+        href="https://developers.google.com/maps/documentation/utilities/polylinealgorithm"
+        >encoded polyline</a
+      >
+      and inside a defined radius. Requires <code>radius</code>.
+    </p>
+  </li>
   <li>
     <h3 class="parameter-name" id="query">query</h3>
     <p>
@@ -176,9 +184,11 @@ <h3>Operators</h3>
   <li>
     <h3 class="parameter-name" id="radius">radius</h3>
     <p>
-      Unit in meters. Used to combine with lat/lng or encoded polyline. To bias
-      the results within a given circular area. 3000 means to search for Assets
-      that are at the most far from 3kms to search area (latlng or polyline).
+      Unit in meters. Used to combine with lat/lng or polyline. To bias the
+      results within a given circular area. 3000 means to search for Assets that
+      are at the most far from 3kms to search area (latlng or polyline). Without
+      <code>radius</code>, <code>lat</code>/<code>lng</code> only sort the
+      Assets by distance.
     </p>
   </li>
   <li>
diff --git a/dist/documentation/parameters/woosmap_http_parameters_storessearch.md b/dist/documentation/parameters/woosmap_http_parameters_storessearch.md
index e64ffa9d..006800d8 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_storessearch.md
+++ b/dist/documentation/parameters/woosmap_http_parameters_storessearch.md
@@ -4,22 +4,26 @@
 
 <h2 id="optional-parameters">Optional parameters</h2>
 
-- <h3 class="parameter-name" id="encoded_polyline">encoded_polyline</h3>
+- <h3 class="parameter-name" id="bounds">bounds</h3>
 
-  Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius.
+  Restricts the results to the Assets inside a bounding box, as `west,south,east,north` in decimal degrees. Takes precedence over `lat`/`lng` and `polyline`.
 
 - <h3 class="parameter-name" id="lat">lat</h3>
 
-  Latitude bias for the results. Should be pass with `lng`.
+  Latitude bias for the results. Must be passed with `lng`.
 
 - <h3 class="parameter-name" id="lng">lng</h3>
 
-  Longitude bias for the results. Should be pass with `lat`.
+  Longitude bias for the results. Must be passed with `lat`.
 
 - <h3 class="parameter-name" id="page">page</h3>
 
   Page number when accessing paginated assets feature collection
 
+- <h3 class="parameter-name" id="polyline">polyline</h3>
+
+  Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius. Requires `radius`.
+
 - <h3 class="parameter-name" id="query">query</h3>
 
   Search query combining one or more search clauses. Each search clause is made up of three parts structured as `field` `:` `operator` `value`. , e.g. `name:="My cool store"`
@@ -80,7 +84,7 @@
 
 - <h3 class="parameter-name" id="radius">radius</h3>
 
-  Unit in meters. Used to combine with lat/lng or encoded polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline).
+  Unit in meters. Used to combine with lat/lng or polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline). Without `radius`, `lat`/`lng` only sort the Assets by distance.
 
 - <h3 class="parameter-name" id="stores_by_page">stores_by_page</h3>
 
diff --git a/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.html b/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.html
index 4a4cc914..2565903d 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.html
+++ b/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.html
@@ -4,11 +4,11 @@ <h2 id="optional-parameters">Optional parameters</h2>
 <ul>
   <li>
     <h3 class="parameter-name" id="lat">lat</h3>
-    <p>Latitude bias for the results. Should be pass with <code>lng</code>.</p>
+    <p>Latitude bias for the results. Must be passed with <code>lng</code>.</p>
   </li>
   <li>
     <h3 class="parameter-name" id="lng">lng</h3>
-    <p>Longitude bias for the results. Should be pass with <code>lat</code>.</p>
+    <p>Longitude bias for the results. Must be passed with <code>lat</code>.</p>
   </li>
   <li>
     <h3 class="parameter-name" id="query">query</h3>
@@ -161,9 +161,11 @@ <h3>Operators</h3>
   <li>
     <h3 class="parameter-name" id="radius">radius</h3>
     <p>
-      Unit in meters. Used to combine with lat/lng or encoded polyline. To bias
-      the results within a given circular area. 3000 means to search for Assets
-      that are at the most far from 3kms to search area (latlng or polyline).
+      Unit in meters. Used to combine with lat/lng or polyline. To bias the
+      results within a given circular area. 3000 means to search for Assets that
+      are at the most far from 3kms to search area (latlng or polyline). Without
+      <code>radius</code>, <code>lat</code>/<code>lng</code> only sort the
+      Assets by distance.
     </p>
   </li>
 </ul>
diff --git a/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.md b/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.md
index bbe877b3..33de9d96 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.md
+++ b/dist/documentation/parameters/woosmap_http_parameters_storessearchbounds.md
@@ -6,11 +6,11 @@
 
 - <h3 class="parameter-name" id="lat">lat</h3>
 
-  Latitude bias for the results. Should be pass with `lng`.
+  Latitude bias for the results. Must be passed with `lng`.
 
 - <h3 class="parameter-name" id="lng">lng</h3>
 
-  Longitude bias for the results. Should be pass with `lat`.
+  Longitude bias for the results. Must be passed with `lat`.
 
 - <h3 class="parameter-name" id="query">query</h3>
 
@@ -72,7 +72,7 @@
 
 - <h3 class="parameter-name" id="radius">radius</h3>
 
-  Unit in meters. Used to combine with lat/lng or encoded polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline).
+  Unit in meters. Used to combine with lat/lng or polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline). Without `radius`, `lat`/`lng` only sort the Assets by distance.
 
 
 <p style="text-align: right; font-size: smaller;">Generated from the <a data-label="openapi-github" href="https://github.com/woosmap/openapi-specification" title="Woosmap OpenAPI Specification" class="external">OpenAPI specification</a>.
diff --git a/dist/documentation/parameters/woosmap_http_parameters_zones.html b/dist/documentation/parameters/woosmap_http_parameters_zones.html
index 7d1563c0..b612376a 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_zones.html
+++ b/dist/documentation/parameters/woosmap_http_parameters_zones.html
@@ -4,7 +4,7 @@ <h2 id="optional-parameters">Optional parameters</h2>
 <ul>
   <li>
     <h3 class="parameter-name" id="limit">limit</h3>
-    <p>To limit number of zones retrieved (max 50).</p>
+    <p>To limit number of zones retrieved (Default is 10, max is 50).</p>
   </li>
   <li>
     <h3 class="parameter-name" id="offset">offset</h3>
diff --git a/dist/documentation/parameters/woosmap_http_parameters_zones.md b/dist/documentation/parameters/woosmap_http_parameters_zones.md
index 160555fe..c3f142c0 100644
--- a/dist/documentation/parameters/woosmap_http_parameters_zones.md
+++ b/dist/documentation/parameters/woosmap_http_parameters_zones.md
@@ -6,7 +6,7 @@
 
 - <h3 class="parameter-name" id="limit">limit</h3>
 
-  To limit number of zones retrieved (max 50).
+  To limit number of zones retrieved (Default is 10, max is 50).
 
 - <h3 class="parameter-name" id="offset">offset</h3>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.html
index 04b941a5..de5df628 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.html
@@ -21,8 +21,8 @@ <h3 class="schema-object" id="AssetAddressResponse">AssetAddressResponse</h3>
           <code>city</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>string</td>
+      <td><strong>required</strong></td>
+      <td>string,null</td>
       <td>
         <div class="nonref-property-description">
           <p>A City where belongs an Asset</p>
@@ -38,7 +38,7 @@ <h3 class="schema-object" id="AssetAddressResponse">AssetAddressResponse</h3>
           <code>country_code</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>string,null</td>
       <td>
         <div class="nonref-property-description">
@@ -63,18 +63,12 @@ <h3 class="schema-object" id="AssetAddressResponse">AssetAddressResponse</h3>
           <code>lines</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>
-        <a href="#AssetAddressLines" title="AssetAddressLines"
-          >AssetAddressLines</a
-        >
-      </td>
+      <td><strong>required</strong></td>
+      <td>array,null</td>
       <td>
-        See
-        <a href="#AssetAddressLines" title="AssetAddressLines"
-          >AssetAddressLines</a
-        >
-        for more information.
+        <div class="nonref-property-description">
+          <p>An Array for lines of an Asset Address</p>
+        </div>
       </td>
     </tr>
     <tr>
@@ -86,8 +80,8 @@ <h3 class="schema-object" id="AssetAddressResponse">AssetAddressResponse</h3>
           <code>zipcode</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>string</td>
+      <td><strong>required</strong></td>
+      <td>string,null</td>
       <td>
         <div class="nonref-property-description">
           <p>An Zipcode / Postal code of an Asset Address</p>
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.md
index f79ad0de..0da0a34e 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetaddressresponse.md
@@ -4,12 +4,12 @@
 
 An object containing the separate components applicable to this address.
 
-| Field                                                                                                                 | Required | Type                                                        | Description                                                                                                                                                                                                                     |
-| :-------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetAddressResponse-city" class="add-link schema-object-property-key"><code>city</code></h4>                 | optional | string                                                      | <div class="nonref-property-description"><p>A City where belongs an Asset</p></div>                                                                                                                                             |
-| <h4 id="AssetAddressResponse-country_code" class="add-link schema-object-property-key"><code>country_code</code></h4> | optional | string,null                                                 | <div class="nonref-property-description"><p>An ISO_3166-1 Country Code where the Asset is located (see <a href="https://en.wikipedia.org/wiki/ISO_3166-1">https://en.wikipedia.org/wiki/ISO_3166-1</a> for full list)</p></div> |
-| <h4 id="AssetAddressResponse-lines" class="add-link schema-object-property-key"><code>lines</code></h4>               | optional | [AssetAddressLines](#AssetAddressLines "AssetAddressLines") | See [AssetAddressLines](#AssetAddressLines "AssetAddressLines") for more information.                                                                                                                                           |
-| <h4 id="AssetAddressResponse-zipcode" class="add-link schema-object-property-key"><code>zipcode</code></h4>           | optional | string                                                      | <div class="nonref-property-description"><p>An Zipcode / Postal code of an Asset Address</p></div>                                                                                                                              |
+| Field                                                                                                                 | Required     | Type        | Description                                                                                                                                                                                                                     |
+| :-------------------------------------------------------------------------------------------------------------------- | ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetAddressResponse-city" class="add-link schema-object-property-key"><code>city</code></h4>                 | **required** | string,null | <div class="nonref-property-description"><p>A City where belongs an Asset</p></div>                                                                                                                                             |
+| <h4 id="AssetAddressResponse-country_code" class="add-link schema-object-property-key"><code>country_code</code></h4> | **required** | string,null | <div class="nonref-property-description"><p>An ISO_3166-1 Country Code where the Asset is located (see <a href="https://en.wikipedia.org/wiki/ISO_3166-1">https://en.wikipedia.org/wiki/ISO_3166-1</a> for full list)</p></div> |
+| <h4 id="AssetAddressResponse-lines" class="add-link schema-object-property-key"><code>lines</code></h4>               | **required** | array,null  | <div class="nonref-property-description"><p>An Array for lines of an Asset Address</p></div>                                                                                                                                    |
+| <h4 id="AssetAddressResponse-zipcode" class="add-link schema-object-property-key"><code>zipcode</code></h4>           | **required** | string,null | <div class="nonref-property-description"><p>An Zipcode / Postal code of an Asset Address</p></div>                                                                                                                              |
 
 <h4 class="schema-object-example" id="AssetAddressResponse-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
index 73ea2447..6045a980 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
@@ -23,7 +23,7 @@ <h3 class="schema-object" id="AssetAutocompleteResponse">
           <code>predictions</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td></td>
       <td>
         <div class="nonref-property-description">
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
index 6d4ba40a..310a45d9 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
@@ -4,9 +4,9 @@
 
 Asset Autocomplete Response with highlighted results on asset name.
 
-| Field                                                                                                                    | Required | Type | Description                                                                                                                                                                                                                               |
-| :----------------------------------------------------------------------------------------------------------------------- | -------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetAutocompleteResponse-predictions" class="add-link schema-object-property-key"><code>predictions</code></h4> | optional |      | <div class="nonref-property-description"><p>A list of predictions based on similarity in all the <code>localizedNames</code> passed in query (or similarity to <code>store_name</code> if no <code>localizedNames</code> exist)</p></div> |
+| Field                                                                                                                    | Required     | Type | Description                                                                                                                                                                                                                               |
+| :----------------------------------------------------------------------------------------------------------------------- | ------------ | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetAutocompleteResponse-predictions" class="add-link schema-object-property-key"><code>predictions</code></h4> | **required** |      | <div class="nonref-property-description"><p>A list of predictions based on similarity in all the <code>localizedNames</code> passed in query (or similarity to <code>store_name</code> if no <code>localizedNames</code> exist)</p></div> |
 
 <h4 class="schema-object-example" id="AssetAutocompleteResponse-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.html
index eb9b8069..ed985f58 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.html
@@ -26,7 +26,7 @@ <h3 class="schema-object" id="AssetFeatureCollectionResponse">
           <code>features</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>
         Array&#x26;lt;<a
           href="#AssetFeatureResponse"
@@ -53,7 +53,7 @@ <h3 class="schema-object" id="AssetFeatureCollectionResponse">
           <code>pagination</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td><a href="#Pagination" title="Pagination">Pagination</a></td>
       <td>
         See <a href="#Pagination" title="Pagination">Pagination</a> for more
@@ -69,7 +69,7 @@ <h3 class="schema-object" id="AssetFeatureCollectionResponse">
           <code>type</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>string</td>
       <td>
         <div class="nonref-property-description">
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.md
index bc1f558a..31136914 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetfeaturecollectionresponse.md
@@ -4,11 +4,11 @@
 
 Assets Collection Response as a GeoJSon FeatureCollection with Asset properties
 
-| Field                                                                                                                       | Required | Type                                                                                | Description                                                                                                                                                                         |
-| :-------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetFeatureCollectionResponse-features" class="add-link schema-object-property-key"><code>features</code></h4>     | optional | Array\&lt;[AssetFeatureResponse](#AssetFeatureResponse "AssetFeatureResponse")\&gt; | <div class="ref-property-description"><p>the Assets Features</p><p>See <a href="#AssetFeatureResponse">AssetFeatureResponse</a> for more information.</div>                         |
-| <h4 id="AssetFeatureCollectionResponse-pagination" class="add-link schema-object-property-key"><code>pagination</code></h4> | optional | [Pagination](#Pagination "Pagination")                                              | See [Pagination](#Pagination "Pagination") for more information.                                                                                                                    |
-| <h4 id="AssetFeatureCollectionResponse-type" class="add-link schema-object-property-key"><code>type</code></h4>             | optional | string                                                                              | <div class="nonref-property-description"><p>the Geojson Type (only 'FeatureCollection')</p><div class="notranslate">The allowed values include: and `FeatureCollection`</div></div> |
+| Field                                                                                                                       | Required     | Type                                                                                | Description                                                                                                                                                                         |
+| :-------------------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetFeatureCollectionResponse-features" class="add-link schema-object-property-key"><code>features</code></h4>     | **required** | Array\&lt;[AssetFeatureResponse](#AssetFeatureResponse "AssetFeatureResponse")\&gt; | <div class="ref-property-description"><p>the Assets Features</p><p>See <a href="#AssetFeatureResponse">AssetFeatureResponse</a> for more information.</div>                         |
+| <h4 id="AssetFeatureCollectionResponse-pagination" class="add-link schema-object-property-key"><code>pagination</code></h4> | **required** | [Pagination](#Pagination "Pagination")                                              | See [Pagination](#Pagination "Pagination") for more information.                                                                                                                    |
+| <h4 id="AssetFeatureCollectionResponse-type" class="add-link schema-object-property-key"><code>type</code></h4>             | **required** | string                                                                              | <div class="nonref-property-description"><p>the Geojson Type (only 'FeatureCollection')</p><div class="notranslate">The allowed values include: and `FeatureCollection`</div></div> |
 
 <h4 class="schema-object-example" id="AssetFeatureCollectionResponse-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.html
index 0e897088..6aa72481 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.html
@@ -21,7 +21,7 @@ <h3 class="schema-object" id="AssetFeatureResponse">AssetFeatureResponse</h3>
           <code>geometry</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td><a href="#GeoJsonPoint" title="GeoJsonPoint">GeoJsonPoint</a></td>
       <td>
         See <a href="#GeoJsonPoint" title="GeoJsonPoint">GeoJsonPoint</a> for
@@ -37,7 +37,7 @@ <h3 class="schema-object" id="AssetFeatureResponse">AssetFeatureResponse</h3>
           <code>properties</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td><a href="#AssetResponse" title="AssetResponse">AssetResponse</a></td>
       <td>
         See <a href="#AssetResponse" title="AssetResponse">AssetResponse</a> for
@@ -53,7 +53,7 @@ <h3 class="schema-object" id="AssetFeatureResponse">AssetFeatureResponse</h3>
           <code>type</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>string</td>
       <td>
         <div class="nonref-property-description">
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.md
index 4ba2feec..dc18f826 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetfeatureresponse.md
@@ -4,11 +4,11 @@
 
 Asset Response as a GeoJSon Feature with Asset properties
 
-| Field                                                                                                             | Required | Type                                            | Description                                                                                                                                                     |
-| :---------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetFeatureResponse-geometry" class="add-link schema-object-property-key"><code>geometry</code></h4>     | optional | [GeoJsonPoint](#GeoJsonPoint "GeoJsonPoint")    | See [GeoJsonPoint](#GeoJsonPoint "GeoJsonPoint") for more information.                                                                                          |
-| <h4 id="AssetFeatureResponse-properties" class="add-link schema-object-property-key"><code>properties</code></h4> | optional | [AssetResponse](#AssetResponse "AssetResponse") | See [AssetResponse](#AssetResponse "AssetResponse") for more information.                                                                                       |
-| <h4 id="AssetFeatureResponse-type" class="add-link schema-object-property-key"><code>type</code></h4>             | optional | string                                          | <div class="nonref-property-description"><p>the Geojson Type (only 'Feature')</p><div class="notranslate">The allowed values include: and `Feature`</div></div> |
+| Field                                                                                                             | Required     | Type                                            | Description                                                                                                                                                     |
+| :---------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetFeatureResponse-geometry" class="add-link schema-object-property-key"><code>geometry</code></h4>     | **required** | [GeoJsonPoint](#GeoJsonPoint "GeoJsonPoint")    | See [GeoJsonPoint](#GeoJsonPoint "GeoJsonPoint") for more information.                                                                                          |
+| <h4 id="AssetFeatureResponse-properties" class="add-link schema-object-property-key"><code>properties</code></h4> | **required** | [AssetResponse](#AssetResponse "AssetResponse") | See [AssetResponse](#AssetResponse "AssetResponse") for more information.                                                                                       |
+| <h4 id="AssetFeatureResponse-type" class="add-link schema-object-property-key"><code>type</code></h4>             | **required** | string                                          | <div class="nonref-property-description"><p>the Geojson Type (only 'Feature')</p><div class="notranslate">The allowed values include: and `Feature`</div></div> |
 
 <h4 class="schema-object-example" id="AssetFeatureResponse-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.html
index 2804a03a..8d6ada02 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.html
@@ -15,102 +15,105 @@ <h3 class="schema-object" id="AssetOpenResponse">AssetOpenResponse</h3>
     <tr>
       <td align="left">
         <h4
-          id="AssetOpenResponse-current_slice"
+          id="AssetOpenResponse-open_hours"
           class="add-link schema-object-property-key"
         >
-          <code>current_slice</code>
+          <code>open_hours</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>
-        <a href="#AssetOpeningHoursPeriod" title="AssetOpeningHoursPeriod"
+        Array&#x26;lt;<a
+          href="#AssetOpeningHoursPeriod"
+          title="AssetOpeningHoursPeriod"
           >AssetOpeningHoursPeriod</a
-        >
+        >&#x26;gt;
       </td>
       <td>
-        See
-        <a href="#AssetOpeningHoursPeriod" title="AssetOpeningHoursPeriod"
-          >AssetOpeningHoursPeriod</a
-        >
-        for more information.
+        <div class="ref-property-description">
+          <p>the opening hours for the day</p>
+          <p>
+            See
+            <a href="#AssetOpeningHoursPeriod">AssetOpeningHoursPeriod</a> for
+            more information.
+          </p>
+        </div>
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetOpenResponse-next_opening"
+          id="AssetOpenResponse-open_now"
           class="add-link schema-object-property-key"
         >
-          <code>next_opening</code>
+          <code>open_now</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>object</td>
+      <td><strong>required</strong></td>
+      <td>boolean</td>
       <td>
         <div class="nonref-property-description">
-          <p>the next opening hours period</p>
+          <p>Boolean value indicating the status of the opening hours</p>
         </div>
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetOpenResponse-open_hours"
+          id="AssetOpenResponse-week_day"
           class="add-link schema-object-property-key"
         >
-          <code>open_hours</code>
+          <code>week_day</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>
-        Array&#x26;lt;<a
-          href="#AssetOpeningHoursPeriod"
-          title="AssetOpeningHoursPeriod"
-          >AssetOpeningHoursPeriod</a
-        >&#x26;gt;
-      </td>
+      <td><strong>required</strong></td>
+      <td>integer</td>
       <td>
-        <div class="ref-property-description">
-          <p>the opening hours for the day</p>
-          <p>
-            See
-            <a href="#AssetOpeningHoursPeriod">AssetOpeningHoursPeriod</a> for
-            more information.
-          </p>
+        <div class="nonref-property-description">
+          <p>the day of the week starting from 1 to 7</p>
         </div>
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetOpenResponse-open_now"
+          id="AssetOpenResponse-current_slice"
           class="add-link schema-object-property-key"
         >
-          <code>open_now</code>
+          <code>current_slice</code>
         </h4>
       </td>
       <td>optional</td>
-      <td>boolean</td>
       <td>
-        <div class="nonref-property-description">
-          <p>Boolean value indicating the status of the opening hours</p>
-        </div>
+        <a href="#AssetOpeningHoursPeriod" title="AssetOpeningHoursPeriod"
+          >AssetOpeningHoursPeriod</a
+        >
+      </td>
+      <td>
+        See
+        <a href="#AssetOpeningHoursPeriod" title="AssetOpeningHoursPeriod"
+          >AssetOpeningHoursPeriod</a
+        >
+        for more information.
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetOpenResponse-week_day"
+          id="AssetOpenResponse-next_opening"
           class="add-link schema-object-property-key"
         >
-          <code>week_day</code>
+          <code>next_opening</code>
         </h4>
       </td>
       <td>optional</td>
-      <td>integer</td>
+      <td>object,null</td>
       <td>
         <div class="nonref-property-description">
-          <p>the day of the week starting from 1 to 7</p>
+          <p>
+            the next opening hours period, returned when the asset is closed.
+            <code>null</code> when the asset does not open in the next days.
+          </p>
         </div>
       </td>
     </tr>
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.md
index 202793e8..a0e70225 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetopenresponse.md
@@ -4,13 +4,13 @@
 
 The Current opening status for an Asset
 
-| Field                                                                                                                | Required | Type                                                                                         | Description                                                                                                                                                                 |
-| :------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetOpenResponse-current_slice" class="add-link schema-object-property-key"><code>current_slice</code></h4> | optional | [AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod")                | See [AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod") for more information.                                                                     |
-| <h4 id="AssetOpenResponse-next_opening" class="add-link schema-object-property-key"><code>next_opening</code></h4>   | optional | object                                                                                       | <div class="nonref-property-description"><p>the next opening hours period</p></div>                                                                                         |
-| <h4 id="AssetOpenResponse-open_hours" class="add-link schema-object-property-key"><code>open_hours</code></h4>       | optional | Array\&lt;[AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod")\&gt; | <div class="ref-property-description"><p>the opening hours for the day</p><p>See <a href="#AssetOpeningHoursPeriod">AssetOpeningHoursPeriod</a> for more information.</div> |
-| <h4 id="AssetOpenResponse-open_now" class="add-link schema-object-property-key"><code>open_now</code></h4>           | optional | boolean                                                                                      | <div class="nonref-property-description"><p>Boolean value indicating the status of the opening hours</p></div>                                                              |
-| <h4 id="AssetOpenResponse-week_day" class="add-link schema-object-property-key"><code>week_day</code></h4>           | optional | integer                                                                                      | <div class="nonref-property-description"><p>the day of the week starting from 1 to 7</p></div>                                                                              |
+| Field                                                                                                                | Required     | Type                                                                                         | Description                                                                                                                                                                              |
+| :------------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetOpenResponse-open_hours" class="add-link schema-object-property-key"><code>open_hours</code></h4>       | **required** | Array\&lt;[AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod")\&gt; | <div class="ref-property-description"><p>the opening hours for the day</p><p>See <a href="#AssetOpeningHoursPeriod">AssetOpeningHoursPeriod</a> for more information.</div>              |
+| <h4 id="AssetOpenResponse-open_now" class="add-link schema-object-property-key"><code>open_now</code></h4>           | **required** | boolean                                                                                      | <div class="nonref-property-description"><p>Boolean value indicating the status of the opening hours</p></div>                                                                           |
+| <h4 id="AssetOpenResponse-week_day" class="add-link schema-object-property-key"><code>week_day</code></h4>           | **required** | integer                                                                                      | <div class="nonref-property-description"><p>the day of the week starting from 1 to 7</p></div>                                                                                           |
+| <h4 id="AssetOpenResponse-current_slice" class="add-link schema-object-property-key"><code>current_slice</code></h4> | optional     | [AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod")                | See [AssetOpeningHoursPeriod](#AssetOpeningHoursPeriod "AssetOpeningHoursPeriod") for more information.                                                                                  |
+| <h4 id="AssetOpenResponse-next_opening" class="add-link schema-object-property-key"><code>next_opening</code></h4>   | optional     | object,null                                                                                  | <div class="nonref-property-description"><p>the next opening hours period, returned when the asset is closed. <code>null</code> when the asset does not open in the next days.</p></div> |
 
 <h4 class="schema-object-example" id="AssetOpenResponse-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetresponse.html
index 59bdb797..4bf14eb5 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetresponse.html
@@ -21,7 +21,7 @@ <h3 class="schema-object" id="AssetResponse">AssetResponse</h3>
           <code>address</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>
         <a href="#AssetAddressResponse" title="AssetAddressResponse"
           >AssetAddressResponse</a
@@ -44,33 +44,13 @@ <h3 class="schema-object" id="AssetResponse">AssetResponse</h3>
           <code>contact</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td><a href="#AssetContact" title="AssetContact">AssetContact</a></td>
       <td>
         See <a href="#AssetContact" title="AssetContact">AssetContact</a> for
         more information.
       </td>
     </tr>
-    <tr>
-      <td align="left">
-        <h4
-          id="AssetResponse-distance"
-          class="add-link schema-object-property-key"
-        >
-          <code>distance</code>
-        </h4>
-      </td>
-      <td>optional</td>
-      <td>number</td>
-      <td>
-        <div class="nonref-property-description">
-          <p>
-            The distance in meters from the geolocated position or searched
-            position if exist
-          </p>
-        </div>
-      </td>
-    </tr>
     <tr>
       <td align="left">
         <h4
@@ -80,7 +60,7 @@ <h3 class="schema-object" id="AssetResponse">AssetResponse</h3>
           <code>last_updated</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>string,null</td>
       <td>
         <div class="nonref-property-description">
@@ -94,7 +74,7 @@ <h4 id="AssetResponse-name" class="add-link schema-object-property-key">
           <code>name</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td><a href="#AssetName" title="AssetName">AssetName</a></td>
       <td>
         See <a href="#AssetName" title="AssetName">AssetName</a> for more
@@ -103,109 +83,149 @@ <h4 id="AssetResponse-name" class="add-link schema-object-property-key">
     </tr>
     <tr>
       <td align="left">
-        <h4 id="AssetResponse-open" class="add-link schema-object-property-key">
-          <code>open</code>
+        <h4
+          id="AssetResponse-store_id"
+          class="add-link schema-object-property-key"
+        >
+          <code>store_id</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
+      <td><a href="#AssetId" title="AssetId">AssetId</a></td>
       <td>
-        <a href="#AssetOpenResponse" title="AssetOpenResponse"
-          >AssetOpenResponse</a
-        >
+        See <a href="#AssetId" title="AssetId">AssetId</a> for more information.
       </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4 id="AssetResponse-tags" class="add-link schema-object-property-key">
+          <code>tags</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td><a href="#AssetTags" title="AssetTags">AssetTags</a></td>
       <td>
-        See
-        <a href="#AssetOpenResponse" title="AssetOpenResponse"
-          >AssetOpenResponse</a
-        >
-        for more information.
+        See <a href="#AssetTags" title="AssetTags">AssetTags</a> for more
+        information.
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetResponse-opening_hours"
+          id="AssetResponse-types"
           class="add-link schema-object-property-key"
         >
-          <code>opening_hours</code>
+          <code>types</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
+      <td><a href="#AssetTypes" title="AssetTypes">AssetTypes</a></td>
       <td>
-        <a href="#AssetOpeningHours" title="AssetOpeningHours"
-          >AssetOpeningHours</a
+        See <a href="#AssetTypes" title="AssetTypes">AssetTypes</a> for more
+        information.
+      </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetResponse-user_properties"
+          class="add-link schema-object-property-key"
         >
+          <code>user_properties</code>
+        </h4>
       </td>
+      <td><strong>required</strong></td>
+      <td>object</td>
       <td>
-        See
-        <a href="#AssetOpeningHours" title="AssetOpeningHours"
-          >AssetOpeningHours</a
-        >
-        for more information.
+        <div class="nonref-property-description">
+          <p>
+            Contains all additional information relative to an Asset. Empty
+            object when not set.
+          </p>
+        </div>
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetResponse-store_id"
+          id="AssetResponse-distance"
           class="add-link schema-object-property-key"
         >
-          <code>store_id</code>
+          <code>distance</code>
         </h4>
       </td>
       <td>optional</td>
-      <td><a href="#AssetId" title="AssetId">AssetId</a></td>
+      <td>number</td>
       <td>
-        See <a href="#AssetId" title="AssetId">AssetId</a> for more information.
+        <div class="nonref-property-description">
+          <p>
+            The distance in meters from the geolocated position or searched
+            position if exist
+          </p>
+        </div>
       </td>
     </tr>
     <tr>
       <td align="left">
-        <h4 id="AssetResponse-tags" class="add-link schema-object-property-key">
-          <code>tags</code>
+        <h4
+          id="AssetResponse-localized_names"
+          class="add-link schema-object-property-key"
+        >
+          <code>localized_names</code>
         </h4>
       </td>
       <td>optional</td>
-      <td><a href="#AssetTags" title="AssetTags">AssetTags</a></td>
+      <td>object</td>
       <td>
-        See <a href="#AssetTags" title="AssetTags">AssetTags</a> for more
-        information.
+        <div class="nonref-property-description">
+          <p>
+            Alternate names of the Asset, keyed by language. Only returned when
+            set.
+          </p>
+        </div>
       </td>
     </tr>
     <tr>
       <td align="left">
-        <h4
-          id="AssetResponse-types"
-          class="add-link schema-object-property-key"
-        >
-          <code>types</code>
+        <h4 id="AssetResponse-open" class="add-link schema-object-property-key">
+          <code>open</code>
         </h4>
       </td>
       <td>optional</td>
-      <td><a href="#AssetTypes" title="AssetTypes">AssetTypes</a></td>
       <td>
-        See <a href="#AssetTypes" title="AssetTypes">AssetTypes</a> for more
-        information.
+        <a href="#AssetOpenResponse" title="AssetOpenResponse"
+          >AssetOpenResponse</a
+        >
+      </td>
+      <td>
+        See
+        <a href="#AssetOpenResponse" title="AssetOpenResponse"
+          >AssetOpenResponse</a
+        >
+        for more information.
       </td>
     </tr>
     <tr>
       <td align="left">
         <h4
-          id="AssetResponse-user_properties"
+          id="AssetResponse-opening_hours"
           class="add-link schema-object-property-key"
         >
-          <code>user_properties</code>
+          <code>opening_hours</code>
         </h4>
       </td>
       <td>optional</td>
-      <td>object,null</td>
       <td>
-        <div class="nonref-property-description">
-          <p>
-            Contains all additional information relative to an Asset. If not set
-            it returns null value.
-          </p>
-        </div>
+        <a href="#AssetOpeningHours" title="AssetOpeningHours"
+          >AssetOpeningHours</a
+        >
+      </td>
+      <td>
+        See
+        <a href="#AssetOpeningHours" title="AssetOpeningHours"
+          >AssetOpeningHours</a
+        >
+        for more information.
       </td>
     </tr>
     <tr>
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetresponse.md
index 22fdc792..4e7cda39 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetresponse.md
@@ -4,20 +4,21 @@
 
 Attributes describing an Asset.
 
-| Field                                                                                                                | Required | Type                                                                                   | Description                                                                                                                                       |
-| :------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetResponse-address" class="add-link schema-object-property-key"><code>address</code></h4>                 | optional | [AssetAddressResponse](#AssetAddressResponse "AssetAddressResponse")                   | See [AssetAddressResponse](#AssetAddressResponse "AssetAddressResponse") for more information.                                                    |
-| <h4 id="AssetResponse-contact" class="add-link schema-object-property-key"><code>contact</code></h4>                 | optional | [AssetContact](#AssetContact "AssetContact")                                           | See [AssetContact](#AssetContact "AssetContact") for more information.                                                                            |
-| <h4 id="AssetResponse-distance" class="add-link schema-object-property-key"><code>distance</code></h4>               | optional | number                                                                                 | <div class="nonref-property-description"><p>The distance in meters from the geolocated position or searched position if exist</p></div>           |
-| <h4 id="AssetResponse-last_updated" class="add-link schema-object-property-key"><code>last_updated</code></h4>       | optional | string,null                                                                            | <div class="nonref-property-description"><p>the previous date timestamp when the asset has been updated</p></div>                                 |
-| <h4 id="AssetResponse-name" class="add-link schema-object-property-key"><code>name</code></h4>                       | optional | [AssetName](#AssetName "AssetName")                                                    | See [AssetName](#AssetName "AssetName") for more information.                                                                                     |
-| <h4 id="AssetResponse-open" class="add-link schema-object-property-key"><code>open</code></h4>                       | optional | [AssetOpenResponse](#AssetOpenResponse "AssetOpenResponse")                            | See [AssetOpenResponse](#AssetOpenResponse "AssetOpenResponse") for more information.                                                             |
-| <h4 id="AssetResponse-opening_hours" class="add-link schema-object-property-key"><code>opening_hours</code></h4>     | optional | [AssetOpeningHours](#AssetOpeningHours "AssetOpeningHours")                            | See [AssetOpeningHours](#AssetOpeningHours "AssetOpeningHours") for more information.                                                             |
-| <h4 id="AssetResponse-store_id" class="add-link schema-object-property-key"><code>store_id</code></h4>               | optional | [AssetId](#AssetId "AssetId")                                                          | See [AssetId](#AssetId "AssetId") for more information.                                                                                           |
-| <h4 id="AssetResponse-tags" class="add-link schema-object-property-key"><code>tags</code></h4>                       | optional | [AssetTags](#AssetTags "AssetTags")                                                    | See [AssetTags](#AssetTags "AssetTags") for more information.                                                                                     |
-| <h4 id="AssetResponse-types" class="add-link schema-object-property-key"><code>types</code></h4>                     | optional | [AssetTypes](#AssetTypes "AssetTypes")                                                 | See [AssetTypes](#AssetTypes "AssetTypes") for more information.                                                                                  |
-| <h4 id="AssetResponse-user_properties" class="add-link schema-object-property-key"><code>user_properties</code></h4> | optional | object,null                                                                            | <div class="nonref-property-description"><p>Contains all additional information relative to an Asset. If not set it returns null value.</p></div> |
-| <h4 id="AssetResponse-weekly_opening" class="add-link schema-object-property-key"><code>weekly_opening</code></h4>   | optional | [AssetWeeklyOpeningResponse](#AssetWeeklyOpeningResponse "AssetWeeklyOpeningResponse") | See [AssetWeeklyOpeningResponse](#AssetWeeklyOpeningResponse "AssetWeeklyOpeningResponse") for more information.                                  |
+| Field                                                                                                                | Required     | Type                                                                                   | Description                                                                                                                                |
+| :------------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| <h4 id="AssetResponse-address" class="add-link schema-object-property-key"><code>address</code></h4>                 | **required** | [AssetAddressResponse](#AssetAddressResponse "AssetAddressResponse")                   | See [AssetAddressResponse](#AssetAddressResponse "AssetAddressResponse") for more information.                                             |
+| <h4 id="AssetResponse-contact" class="add-link schema-object-property-key"><code>contact</code></h4>                 | **required** | [AssetContact](#AssetContact "AssetContact")                                           | See [AssetContact](#AssetContact "AssetContact") for more information.                                                                     |
+| <h4 id="AssetResponse-last_updated" class="add-link schema-object-property-key"><code>last_updated</code></h4>       | **required** | string,null                                                                            | <div class="nonref-property-description"><p>the previous date timestamp when the asset has been updated</p></div>                          |
+| <h4 id="AssetResponse-name" class="add-link schema-object-property-key"><code>name</code></h4>                       | **required** | [AssetName](#AssetName "AssetName")                                                    | See [AssetName](#AssetName "AssetName") for more information.                                                                              |
+| <h4 id="AssetResponse-store_id" class="add-link schema-object-property-key"><code>store_id</code></h4>               | **required** | [AssetId](#AssetId "AssetId")                                                          | See [AssetId](#AssetId "AssetId") for more information.                                                                                    |
+| <h4 id="AssetResponse-tags" class="add-link schema-object-property-key"><code>tags</code></h4>                       | **required** | [AssetTags](#AssetTags "AssetTags")                                                    | See [AssetTags](#AssetTags "AssetTags") for more information.                                                                              |
+| <h4 id="AssetResponse-types" class="add-link schema-object-property-key"><code>types</code></h4>                     | **required** | [AssetTypes](#AssetTypes "AssetTypes")                                                 | See [AssetTypes](#AssetTypes "AssetTypes") for more information.                                                                           |
+| <h4 id="AssetResponse-user_properties" class="add-link schema-object-property-key"><code>user_properties</code></h4> | **required** | object                                                                                 | <div class="nonref-property-description"><p>Contains all additional information relative to an Asset. Empty object when not set.</p></div> |
+| <h4 id="AssetResponse-distance" class="add-link schema-object-property-key"><code>distance</code></h4>               | optional     | number                                                                                 | <div class="nonref-property-description"><p>The distance in meters from the geolocated position or searched position if exist</p></div>    |
+| <h4 id="AssetResponse-localized_names" class="add-link schema-object-property-key"><code>localized_names</code></h4> | optional     | object                                                                                 | <div class="nonref-property-description"><p>Alternate names of the Asset, keyed by language. Only returned when set.</p></div>             |
+| <h4 id="AssetResponse-open" class="add-link schema-object-property-key"><code>open</code></h4>                       | optional     | [AssetOpenResponse](#AssetOpenResponse "AssetOpenResponse")                            | See [AssetOpenResponse](#AssetOpenResponse "AssetOpenResponse") for more information.                                                      |
+| <h4 id="AssetResponse-opening_hours" class="add-link schema-object-property-key"><code>opening_hours</code></h4>     | optional     | [AssetOpeningHours](#AssetOpeningHours "AssetOpeningHours")                            | See [AssetOpeningHours](#AssetOpeningHours "AssetOpeningHours") for more information.                                                      |
+| <h4 id="AssetResponse-weekly_opening" class="add-link schema-object-property-key"><code>weekly_opening</code></h4>   | optional     | [AssetWeeklyOpeningResponse](#AssetWeeklyOpeningResponse "AssetWeeklyOpeningResponse") | See [AssetWeeklyOpeningResponse](#AssetWeeklyOpeningResponse "AssetWeeklyOpeningResponse") for more information.                           |
 
 <p style="text-align: right; font-size: smaller;">Generated from the <a data-label="openapi-github" href="https://github.com/woosmap/openapi-specification" title="Woosmap OpenAPI Specification" class="external">OpenAPI specification</a>.
 <a data-label="openapi-github-woosmap-http-schema-assetresponse" data-action="edit" style="margin-left: 5px;" href="https://github.com/woosmap/openapi-specification/blob/main/specification/schemas/AssetResponse.yml" title="Edit on GitHub">✎ Edit</a>
diff --git a/dist/documentation/schemas/woosmap_http_schema_boundsresponse.html b/dist/documentation/schemas/woosmap_http_schema_boundsresponse.html
index b5b2fe0c..d65f52be 100644
--- a/dist/documentation/schemas/woosmap_http_schema_boundsresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_boundsresponse.html
@@ -21,10 +21,12 @@ <h3 class="schema-object" id="BoundsResponse">BoundsResponse</h3>
           <code>bounds</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>object</td>
       <td>
-        <div class="nonref-property-description"><p>The bounds object</p></div>
+        <div class="nonref-property-description">
+          <p>The bounds object, empty when no asset matches.</p>
+        </div>
       </td>
     </tr>
   </tbody>
diff --git a/dist/documentation/schemas/woosmap_http_schema_boundsresponse.md b/dist/documentation/schemas/woosmap_http_schema_boundsresponse.md
index e185c71a..5ff13531 100644
--- a/dist/documentation/schemas/woosmap_http_schema_boundsresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_boundsresponse.md
@@ -4,9 +4,9 @@
 
 Message returned to a success Search Bounds request
 
-| Field                                                                                               | Required | Type   | Description                                                             |
-| :-------------------------------------------------------------------------------------------------- | -------- | ------ | ----------------------------------------------------------------------- |
-| <h4 id="BoundsResponse-bounds" class="add-link schema-object-property-key"><code>bounds</code></h4> | optional | object | <div class="nonref-property-description"><p>The bounds object</p></div> |
+| Field                                                                                               | Required     | Type   | Description                                                                                           |
+| :-------------------------------------------------------------------------------------------------- | ------------ | ------ | ----------------------------------------------------------------------------------------------------- |
+| <h4 id="BoundsResponse-bounds" class="add-link schema-object-property-key"><code>bounds</code></h4> | **required** | object | <div class="nonref-property-description"><p>The bounds object, empty when no asset matches.</p></div> |
 
 <p style="text-align: right; font-size: smaller;">Generated from the <a data-label="openapi-github" href="https://github.com/woosmap/openapi-specification" title="Woosmap OpenAPI Specification" class="external">OpenAPI specification</a>.
 <a data-label="openapi-github-woosmap-http-schema-boundsresponse" data-action="edit" style="margin-left: 5px;" href="https://github.com/woosmap/openapi-specification/blob/main/specification/schemas/BoundsResponse.yml" title="Edit on GitHub">✎ Edit</a>
diff --git a/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.html b/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.html
index cfde98fa..0c710373 100644
--- a/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.html
+++ b/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.html
@@ -21,7 +21,7 @@ <h3 class="schema-object" id="GeoJsonPoint">GeoJsonPoint</h3>
           <code>coordinates</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>
         <a href="#LatLngArrayString" title="LatLngArrayString"
           >LatLngArrayString</a
@@ -41,7 +41,7 @@ <h4 id="GeoJsonPoint-type" class="add-link schema-object-property-key">
           <code>type</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>string</td>
       <td>
         <div class="nonref-property-description">
diff --git a/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.md b/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.md
index 2ab47b27..b624422d 100644
--- a/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.md
+++ b/dist/documentation/schemas/woosmap_http_schema_geojsonpoint.md
@@ -4,10 +4,10 @@
 
 GeoJSon Point Geometry
 
-| Field                                                                                                       | Required | Type                                                        | Description                                                                                                                                   |
-| :---------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="GeoJsonPoint-coordinates" class="add-link schema-object-property-key"><code>coordinates</code></h4> | optional | [LatLngArrayString](#LatLngArrayString "LatLngArrayString") | See [LatLngArrayString](#LatLngArrayString "LatLngArrayString") for more information.                                                         |
-| <h4 id="GeoJsonPoint-type" class="add-link schema-object-property-key"><code>type</code></h4>               | optional | string                                                      | <div class="nonref-property-description"><p>the geometry type</p><div class="notranslate">The allowed values include: and `Point`</div></div> |
+| Field                                                                                                       | Required     | Type                                                        | Description                                                                                                                                   |
+| :---------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="GeoJsonPoint-coordinates" class="add-link schema-object-property-key"><code>coordinates</code></h4> | **required** | [LatLngArrayString](#LatLngArrayString "LatLngArrayString") | See [LatLngArrayString](#LatLngArrayString "LatLngArrayString") for more information.                                                         |
+| <h4 id="GeoJsonPoint-type" class="add-link schema-object-property-key"><code>type</code></h4>               | **required** | string                                                      | <div class="nonref-property-description"><p>the geometry type</p><div class="notranslate">The allowed values include: and `Point`</div></div> |
 
 <h4 class="schema-object-example" id="GeoJsonPoint-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.html b/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.html
index 96a3cdcf..662cde0d 100644
--- a/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.html
+++ b/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.html
@@ -20,8 +20,8 @@ <h3 class="schema-object" id="MatchedSubstring">MatchedSubstring</h3>
           <code>length</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>number</td>
+      <td><strong>required</strong></td>
+      <td>integer</td>
       <td>
         <div class="nonref-property-description">
           <p>Length of the matched substring in the prediction result text.</p>
@@ -37,8 +37,8 @@ <h3 class="schema-object" id="MatchedSubstring">MatchedSubstring</h3>
           <code>offset</code>
         </h4>
       </td>
-      <td>optional</td>
-      <td>number</td>
+      <td><strong>required</strong></td>
+      <td>integer</td>
       <td>
         <div class="nonref-property-description">
           <p>
diff --git a/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.md b/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.md
index aaaf7ca0..156874cb 100644
--- a/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.md
+++ b/dist/documentation/schemas/woosmap_http_schema_matchedsubstring.md
@@ -2,10 +2,10 @@
 <!--- [START woosmap_http_schema_matchedsubstring] -->
 <h3 class="schema-object" id="MatchedSubstring">MatchedSubstring</h3>
 
-| Field                                                                                                 | Required | Type   | Description                                                                                                                  |
-| :---------------------------------------------------------------------------------------------------- | -------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="MatchedSubstring-length" class="add-link schema-object-property-key"><code>length</code></h4> | optional | number | <div class="nonref-property-description"><p>Length of the matched substring in the prediction result text.</p></div>         |
-| <h4 id="MatchedSubstring-offset" class="add-link schema-object-property-key"><code>offset</code></h4> | optional | number | <div class="nonref-property-description"><p>Start location of the matched substring in the prediction result text.</p></div> |
+| Field                                                                                                 | Required     | Type    | Description                                                                                                                  |
+| :---------------------------------------------------------------------------------------------------- | ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="MatchedSubstring-length" class="add-link schema-object-property-key"><code>length</code></h4> | **required** | integer | <div class="nonref-property-description"><p>Length of the matched substring in the prediction result text.</p></div>         |
+| <h4 id="MatchedSubstring-offset" class="add-link schema-object-property-key"><code>offset</code></h4> | **required** | integer | <div class="nonref-property-description"><p>Start location of the matched substring in the prediction result text.</p></div> |
 
 <h4 class="schema-object-example" id="MatchedSubstring-example">Example</h4>
 
diff --git a/dist/documentation/schemas/woosmap_http_schema_pagination.html b/dist/documentation/schemas/woosmap_http_schema_pagination.html
index 002e50d9..3c08bc14 100644
--- a/dist/documentation/schemas/woosmap_http_schema_pagination.html
+++ b/dist/documentation/schemas/woosmap_http_schema_pagination.html
@@ -18,7 +18,7 @@ <h4 id="Pagination-page" class="add-link schema-object-property-key">
           <code>page</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>integer</td>
       <td>
         <div class="nonref-property-description"><p>the request page</p></div>
@@ -33,7 +33,7 @@ <h4 id="Pagination-page" class="add-link schema-object-property-key">
           <code>pageCount</code>
         </h4>
       </td>
-      <td>optional</td>
+      <td><strong>required</strong></td>
       <td>integer</td>
       <td>
         <div class="nonref-property-description">
diff --git a/dist/documentation/schemas/woosmap_http_schema_pagination.md b/dist/documentation/schemas/woosmap_http_schema_pagination.md
index 893122cb..4068e19d 100644
--- a/dist/documentation/schemas/woosmap_http_schema_pagination.md
+++ b/dist/documentation/schemas/woosmap_http_schema_pagination.md
@@ -4,10 +4,10 @@
 
 Pagination to reach all returned assets. max 300 assets par page.
 
-| Field                                                                                                 | Required | Type    | Description                                                                         |
-| :---------------------------------------------------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------- |
-| <h4 id="Pagination-page" class="add-link schema-object-property-key"><code>page</code></h4>           | optional | integer | <div class="nonref-property-description"><p>the request page</p></div>              |
-| <h4 id="Pagination-pageCount" class="add-link schema-object-property-key"><code>pageCount</code></h4> | optional | integer | <div class="nonref-property-description"><p>the number of available pages</p></div> |
+| Field                                                                                                 | Required     | Type    | Description                                                                         |
+| :---------------------------------------------------------------------------------------------------- | ------------ | ------- | ----------------------------------------------------------------------------------- |
+| <h4 id="Pagination-page" class="add-link schema-object-property-key"><code>page</code></h4>           | **required** | integer | <div class="nonref-property-description"><p>the request page</p></div>              |
+| <h4 id="Pagination-pageCount" class="add-link schema-object-property-key"><code>pageCount</code></h4> | **required** | integer | <div class="nonref-property-description"><p>the number of available pages</p></div> |
 
 <p style="text-align: right; font-size: smaller;">Generated from the <a data-label="openapi-github" href="https://github.com/woosmap/openapi-specification" title="Woosmap OpenAPI Specification" class="external">OpenAPI specification</a>.
 <a data-label="openapi-github-woosmap-http-schema-pagination" data-action="edit" style="margin-left: 5px;" href="https://github.com/woosmap/openapi-specification/blob/main/specification/schemas/Pagination.yml" title="Edit on GitHub">✎ Edit</a>
diff --git a/dist/woosmap-openapi3.json b/dist/woosmap-openapi3.json
index 6419aeba..3eac1e1f 100755
--- a/dist/woosmap-openapi3.json
+++ b/dist/woosmap-openapi3.json
@@ -1712,7 +1712,10 @@
             "$ref": "#/components/parameters/radius"
           },
           {
-            "$ref": "#/components/parameters/encoded_polyline"
+            "$ref": "#/components/parameters/polyline"
+          },
+          {
+            "$ref": "#/components/parameters/bounds"
           },
           {
             "$ref": "#/components/parameters/stores_by_page"
@@ -2005,7 +2008,7 @@
         "tags": [
           "Store Search"
         ],
-        "description": "Autocomplete on `localizedNames` with highlighted results on asset name. Use the field `localized` in your query parameter to search for localized names.\n",
+        "description": "Autocomplete on `localizedNames` with highlighted results on asset name. Use the field `localized` in your query parameter to search for localized names. Without `query`, the response has no predictions.\n",
         "security": [
           {
             "PublicApiKeyAuth": [],
@@ -3098,7 +3101,7 @@
       },
       "lat": {
         "name": "lat",
-        "description": "Latitude bias for the results. Should be pass with `lng`.\n",
+        "description": "Latitude bias for the results. Must be passed with `lng`.\n",
         "schema": {
           "type": "number",
           "example": 5.2
@@ -3107,7 +3110,7 @@
       },
       "lng": {
         "name": "lng",
-        "description": "Longitude bias for the results. Should be pass with `lat`.\n",
+        "description": "Longitude bias for the results. Must be passed with `lat`.\n",
         "schema": {
           "type": "number",
           "example": 3.5
@@ -3116,22 +3119,31 @@
       },
       "radius": {
         "name": "radius",
-        "description": "Unit in meters. Used to combine with lat/lng or encoded polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline).\n",
+        "description": "Unit in meters. Used to combine with lat/lng or polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline). Without `radius`, `lat`/`lng` only sort the Assets by distance.\n",
         "schema": {
           "type": "number",
           "example": 3000
         },
         "in": "query"
       },
-      "encoded_polyline": {
-        "name": "encoded_polyline",
-        "description": "Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius.\n",
+      "polyline": {
+        "name": "polyline",
+        "description": "Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius. Requires `radius`.\n",
         "schema": {
           "type": "string",
           "example": "_p~iF~ps|U_ulLnnqC_mqNvxq`@"
         },
         "in": "query"
       },
+      "bounds": {
+        "name": "bounds",
+        "description": "Restricts the results to the Assets inside a bounding box, as `west,south,east,north` in decimal degrees. Takes precedence over `lat`/`lng` and `polyline`.\n",
+        "schema": {
+          "type": "string",
+          "example": "2.29,48.85,2.35,48.87"
+        },
+        "in": "query"
+      },
       "stores_by_page": {
         "name": "stores_by_page",
         "description": "If your request returns a high number of assets, the result will be paginated. If so, you can request assets by page using `page` and `stores_by_page` parameters (Default is 100, max is 300).\n",
@@ -3139,6 +3151,7 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 300,
+          "default": 100,
           "example": 150
         },
         "in": "query"
@@ -3148,6 +3161,8 @@
         "description": "Page number when accessing paginated assets feature collection\n",
         "schema": {
           "type": "integer",
+          "minimum": 1,
+          "default": 1,
           "example": 2
         },
         "in": "query"
@@ -3177,17 +3192,19 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 50,
+          "default": 5,
           "example": 15
         },
         "in": "query"
       },
       "limit-3": {
         "name": "limit",
-        "description": "To limit number of zones retrieved (max 50).\n",
+        "description": "To limit number of zones retrieved (Default is 10, max is 50).\n",
         "schema": {
           "type": "integer",
           "minimum": 1,
           "maximum": 50,
+          "default": 10,
           "example": 10
         },
         "in": "query"
@@ -3197,7 +3214,8 @@
         "description": "To retrieve zones starting from an offset value.\n",
         "schema": {
           "type": "integer",
-          "minimum": 1,
+          "minimum": 0,
+          "default": 0,
           "example": 20
         },
         "in": "query"
@@ -3401,26 +3419,30 @@
         "type": "string",
         "example": "STORE_ID_12345"
       },
-      "AssetAddressLines": {
-        "title": "AssetAddressLines",
-        "description": "An Array for lines of an Asset Address",
-        "type": "array",
-        "example": [
-          "Building Centre",
-          "26 Store Street"
-        ],
-        "items": {
-          "type": "string",
-          "example": "26 Store Street"
-        }
-      },
       "AssetAddressResponse": {
         "title": "AssetAddressResponse",
         "type": "object",
         "description": "An object containing the separate components applicable to this address.",
+        "required": [
+          "lines",
+          "country_code",
+          "city",
+          "zipcode"
+        ],
         "properties": {
           "lines": {
-            "$ref": "#/components/schemas/AssetAddressLines"
+            "description": "An Array for lines of an Asset Address",
+            "type": [
+              "array",
+              "null"
+            ],
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "Building Centre",
+              "26 Store Street"
+            ]
           },
           "country_code": {
             "description": "An ISO_3166-1 Country Code where the Asset is located (see <https://en.wikipedia.org/wiki/ISO_3166-1> for full list)",
@@ -3432,12 +3454,18 @@
           },
           "city": {
             "description": "A City where belongs an Asset",
-            "type": "string",
+            "type": [
+              "string",
+              "null"
+            ],
             "example": "London"
           },
           "zipcode": {
             "description": "An Zipcode / Postal code of an Asset Address",
-            "type": "string",
+            "type": [
+              "string",
+              "null"
+            ],
             "example": "WC1E 7BT"
           }
         },
@@ -3506,6 +3534,11 @@
         "title": "AssetOpenResponse",
         "type": "object",
         "description": "The Current opening status for an Asset",
+        "required": [
+          "open_now",
+          "open_hours",
+          "week_day"
+        ],
         "properties": {
           "current_slice": {
             "$ref": "#/components/schemas/AssetOpeningHoursPeriod"
@@ -3522,19 +3555,29 @@
             "type": "boolean"
           },
           "next_opening": {
-            "description": "the next opening hours period",
-            "type": "object",
+            "description": "the next opening hours period, returned when the asset is closed. `null` when the asset does not open in the next days.",
+            "type": [
+              "object",
+              "null"
+            ],
+            "required": [
+              "day"
+            ],
             "properties": {
               "end": {
-                "description": "the hours of next opening",
+                "description": "the hours of next closing",
                 "type": "string",
                 "example": "17:30"
               },
               "start": {
-                "description": "the hours of next closing",
+                "description": "the hours of next opening",
                 "type": "string",
                 "example": "06:00"
               },
+              "all-day": {
+                "description": "true when the asset is open all day, in place of `start` and `end`",
+                "type": "boolean"
+              },
               "day": {
                 "type": "string",
                 "description": "the day of next opening",
@@ -3835,6 +3878,16 @@
         "title": "AssetResponse",
         "type": "object",
         "description": "Attributes describing an Asset.",
+        "required": [
+          "store_id",
+          "name",
+          "address",
+          "contact",
+          "types",
+          "tags",
+          "last_updated",
+          "user_properties"
+        ],
         "properties": {
           "name": {
             "$ref": "#/components/schemas/AssetName"
@@ -3869,11 +3922,8 @@
             "example": "2022-11-08T15:48:08.556803+00:00"
           },
           "user_properties": {
-            "description": "Contains all additional information relative to an Asset. If not set it returns null value.",
-            "type": [
-              "object",
-              "null"
-            ],
+            "description": "Contains all additional information relative to an Asset. Empty object when not set.",
+            "type": "object",
             "additionalProperties": true,
             "example": {
               "some_user_properties": "some_value"
@@ -3882,6 +3932,17 @@
           "opening_hours": {
             "$ref": "#/components/schemas/AssetOpeningHours"
           },
+          "localized_names": {
+            "description": "Alternate names of the Asset, keyed by language. Only returned when set.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "example": {
+              "fr": "Centre Commercial Velizy",
+              "it": "Centro Commerciale Velizy"
+            }
+          },
           "distance": {
             "description": "The distance in meters from the geolocated position or searched position if exist",
             "type": "number",
@@ -3907,6 +3968,10 @@
         "title": "GeoJsonPoint",
         "type": "object",
         "description": "GeoJSon Point Geometry",
+        "required": [
+          "type",
+          "coordinates"
+        ],
         "properties": {
           "type": {
             "type": "string",
@@ -3931,6 +3996,11 @@
         "title": "AssetFeatureResponse",
         "type": "object",
         "description": "Asset Response as a GeoJSon Feature with Asset properties",
+        "required": [
+          "type",
+          "properties",
+          "geometry"
+        ],
         "properties": {
           "type": {
             "description": "the Geojson Type (only 'Feature')",
@@ -4127,6 +4197,10 @@
         "title": "Pagination",
         "type": "object",
         "description": "Pagination to reach all returned assets. max 300 assets par page.",
+        "required": [
+          "page",
+          "pageCount"
+        ],
         "properties": {
           "page": {
             "type": "integer",
@@ -4144,6 +4218,11 @@
         "title": "AssetFeatureCollectionResponse",
         "type": "object",
         "description": "Assets Collection Response as a GeoJSon FeatureCollection with Asset properties",
+        "required": [
+          "type",
+          "features",
+          "pagination"
+        ],
         "properties": {
           "type": {
             "description": "the Geojson Type (only 'FeatureCollection')",
@@ -4625,6 +4704,19 @@
           "dst_offset": 3600
         }
       },
+      "AssetAddressLines": {
+        "title": "AssetAddressLines",
+        "description": "An Array for lines of an Asset Address",
+        "type": "array",
+        "example": [
+          "Building Centre",
+          "26 Store Street"
+        ],
+        "items": {
+          "type": "string",
+          "example": "26 Store Street"
+        }
+      },
       "AssetAddressRequest": {
         "title": "AssetAddressRequest",
         "type": "object",
@@ -4879,14 +4971,18 @@
       "MatchedSubstring": {
         "title": "MatchedSubstring",
         "type": "object",
+        "required": [
+          "offset",
+          "length"
+        ],
         "properties": {
           "length": {
             "description": "Length of the matched substring in the prediction result text.",
-            "type": "number"
+            "type": "integer"
           },
           "offset": {
             "description": "Start location of the matched substring in the prediction result text.",
-            "type": "number"
+            "type": "integer"
           }
         },
         "example": {
@@ -4898,11 +4994,21 @@
         "title": "AssetAutocompleteResponse",
         "type": "object",
         "description": "Asset Autocomplete Response with highlighted results on asset name.",
+        "required": [
+          "predictions"
+        ],
         "properties": {
           "predictions": {
             "description": "A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)",
             "items": {
               "type": "object",
+              "required": [
+                "store_id",
+                "name",
+                "types",
+                "matched_substrings",
+                "highlighted"
+              ],
               "properties": {
                 "name": {
                   "description": "The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists, or else the default name property.\n",
@@ -4981,9 +5087,12 @@
         "title": "BoundsResponse",
         "type": "object",
         "description": "Message returned to a success Search Bounds request",
+        "required": [
+          "bounds"
+        ],
         "properties": {
           "bounds": {
-            "description": "The bounds object",
+            "description": "The bounds object, empty when no asset matches.",
             "type": "object",
             "properties": {
               "west": {
diff --git a/dist/woosmap-openapi3.yml b/dist/woosmap-openapi3.yml
index 769ed060..7b38b6f9 100755
--- a/dist/woosmap-openapi3.yml
+++ b/dist/woosmap-openapi3.yml
@@ -2051,7 +2051,8 @@ paths:
         - $ref: '#/components/parameters/lat'
         - $ref: '#/components/parameters/lng'
         - $ref: '#/components/parameters/radius'
-        - $ref: '#/components/parameters/encoded_polyline'
+        - $ref: '#/components/parameters/polyline'
+        - $ref: '#/components/parameters/bounds'
         - $ref: '#/components/parameters/stores_by_page'
         - $ref: '#/components/parameters/page'
         - $ref: '#/components/parameters/zone'
@@ -2248,7 +2249,7 @@ paths:
       tags:
         - Store Search
       description: |
-        Autocomplete on `localizedNames` with highlighted results on asset name. Use the field `localized` in your query parameter to search for localized names.
+        Autocomplete on `localizedNames` with highlighted results on asset name. Use the field `localized` in your query parameter to search for localized names. Without `query`, the response has no predictions.
       security:
         - PublicApiKeyAuth: []
           RefererHeader: []
@@ -3297,7 +3298,7 @@ components:
     lat:
       name: lat
       description: |
-        Latitude bias for the results. Should be pass with `lng`.
+        Latitude bias for the results. Must be passed with `lng`.
       schema:
         type: number
         example: 5.2
@@ -3305,7 +3306,7 @@ components:
     lng:
       name: lng
       description: |
-        Longitude bias for the results. Should be pass with `lat`.
+        Longitude bias for the results. Must be passed with `lat`.
       schema:
         type: number
         example: 3.5
@@ -3313,19 +3314,27 @@ components:
     radius:
       name: radius
       description: |
-        Unit in meters. Used to combine with lat/lng or encoded polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline).
+        Unit in meters. Used to combine with lat/lng or polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline). Without `radius`, `lat`/`lng` only sort the Assets by distance.
       schema:
         type: number
         example: 3000
       in: query
-    encoded_polyline:
-      name: encoded_polyline
+    polyline:
+      name: polyline
       description: |
-        Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius.
+        Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius. Requires `radius`.
       schema:
         type: string
         example: _p~iF~ps|U_ulLnnqC_mqNvxq`@
       in: query
+    bounds:
+      name: bounds
+      description: |
+        Restricts the results to the Assets inside a bounding box, as `west,south,east,north` in decimal degrees. Takes precedence over `lat`/`lng` and `polyline`.
+      schema:
+        type: string
+        example: 2.29,48.85,2.35,48.87
+      in: query
     stores_by_page:
       name: stores_by_page
       description: |
@@ -3334,6 +3343,7 @@ components:
         type: integer
         minimum: 1
         maximum: 300
+        default: 100
         example: 150
       in: query
     page:
@@ -3342,6 +3352,8 @@ components:
         Page number when accessing paginated assets feature collection
       schema:
         type: integer
+        minimum: 1
+        default: 1
         example: 2
       in: query
     zone:
@@ -3368,16 +3380,18 @@ components:
         type: integer
         minimum: 1
         maximum: 50
+        default: 5
         example: 15
       in: query
     limit-3:
       name: limit
       description: |
-        To limit number of zones retrieved (max 50).
+        To limit number of zones retrieved (Default is 10, max is 50).
       schema:
         type: integer
         minimum: 1
         maximum: 50
+        default: 10
         example: 10
       in: query
     offset:
@@ -3386,7 +3400,8 @@ components:
         To retrieve zones starting from an offset value.
       schema:
         type: integer
-        minimum: 1
+        minimum: 0
+        default: 0
         example: 20
       in: query
   schemas:
@@ -3543,23 +3558,26 @@ components:
         A textual identifier that uniquely identifies an Asset. It must matches the following regexp `[A-Za-z0-9]+`
       type: string
       example: STORE_ID_12345
-    AssetAddressLines:
-      title: AssetAddressLines
-      description: An Array for lines of an Asset Address
-      type: array
-      example:
-        - Building Centre
-        - 26 Store Street
-      items:
-        type: string
-        example: 26 Store Street
     AssetAddressResponse:
       title: AssetAddressResponse
       type: object
       description: An object containing the separate components applicable to this address.
+      required:
+        - lines
+        - country_code
+        - city
+        - zipcode
       properties:
         lines:
-          $ref: '#/components/schemas/AssetAddressLines'
+          description: An Array for lines of an Asset Address
+          type:
+            - array
+            - 'null'
+          items:
+            type: string
+          example:
+            - Building Centre
+            - 26 Store Street
         country_code:
           description: An ISO_3166-1 Country Code where the Asset is located (see <https://en.wikipedia.org/wiki/ISO_3166-1> for full list)
           type:
@@ -3568,11 +3586,15 @@ components:
           example: UK
         city:
           description: A City where belongs an Asset
-          type: string
+          type:
+            - string
+            - 'null'
           example: London
         zipcode:
           description: An Zipcode / Postal code of an Asset Address
-          type: string
+          type:
+            - string
+            - 'null'
           example: WC1E 7BT
       example:
         lines:
@@ -3624,6 +3646,10 @@ components:
       title: AssetOpenResponse
       type: object
       description: The Current opening status for an Asset
+      required:
+        - open_now
+        - open_hours
+        - week_day
       properties:
         current_slice:
           $ref: '#/components/schemas/AssetOpeningHoursPeriod'
@@ -3636,17 +3662,24 @@ components:
           description: Boolean value indicating the status of the opening hours
           type: boolean
         next_opening:
-          description: the next opening hours period
-          type: object
+          description: the next opening hours period, returned when the asset is closed. `null` when the asset does not open in the next days.
+          type:
+            - object
+            - 'null'
+          required:
+            - day
           properties:
             end:
-              description: the hours of next opening
+              description: the hours of next closing
               type: string
               example: '17:30'
             start:
-              description: the hours of next closing
+              description: the hours of next opening
               type: string
               example: '06:00'
+            all-day:
+              description: true when the asset is open all day, in place of `start` and `end`
+              type: boolean
             day:
               type: string
               description: the day of next opening
@@ -3847,6 +3880,15 @@ components:
       title: AssetResponse
       type: object
       description: Attributes describing an Asset.
+      required:
+        - store_id
+        - name
+        - address
+        - contact
+        - types
+        - tags
+        - last_updated
+        - user_properties
       properties:
         name:
           $ref: '#/components/schemas/AssetName'
@@ -3871,15 +3913,21 @@ components:
           description: the previous date timestamp when the asset has been updated
           example: '2022-11-08T15:48:08.556803+00:00'
         user_properties:
-          description: Contains all additional information relative to an Asset. If not set it returns null value.
-          type:
-            - object
-            - 'null'
+          description: Contains all additional information relative to an Asset. Empty object when not set.
+          type: object
           additionalProperties: true
           example:
             some_user_properties: some_value
         opening_hours:
           $ref: '#/components/schemas/AssetOpeningHours'
+        localized_names:
+          description: Alternate names of the Asset, keyed by language. Only returned when set.
+          type: object
+          additionalProperties:
+            type: string
+          example:
+            fr: Centre Commercial Velizy
+            it: Centro Commerciale Velizy
         distance:
           description: The distance in meters from the geolocated position or searched position if exist
           type: number
@@ -3899,6 +3947,9 @@ components:
       title: GeoJsonPoint
       type: object
       description: GeoJSon Point Geometry
+      required:
+        - type
+        - coordinates
       properties:
         type:
           type: string
@@ -3916,6 +3967,10 @@ components:
       title: AssetFeatureResponse
       type: object
       description: Asset Response as a GeoJSon Feature with Asset properties
+      required:
+        - type
+        - properties
+        - geometry
       properties:
         type:
           description: the Geojson Type (only 'Feature')
@@ -4039,6 +4094,9 @@ components:
       title: Pagination
       type: object
       description: Pagination to reach all returned assets. max 300 assets par page.
+      required:
+        - page
+        - pageCount
       properties:
         page:
           type: integer
@@ -4052,6 +4110,10 @@ components:
       title: AssetFeatureCollectionResponse
       type: object
       description: Assets Collection Response as a GeoJSon FeatureCollection with Asset properties
+      required:
+        - type
+        - features
+        - pagination
       properties:
         type:
           description: the Geojson Type (only 'FeatureCollection')
@@ -4372,6 +4434,16 @@ components:
         timezone_name: CEST
         raw_offset: 3600
         dst_offset: 3600
+    AssetAddressLines:
+      title: AssetAddressLines
+      description: An Array for lines of an Asset Address
+      type: array
+      example:
+        - Building Centre
+        - 26 Store Street
+      items:
+        type: string
+        example: 26 Store Street
     AssetAddressRequest:
       title: AssetAddressRequest
       type: object
@@ -4549,13 +4621,16 @@ components:
     MatchedSubstring:
       title: MatchedSubstring
       type: object
+      required:
+        - offset
+        - length
       properties:
         length:
           description: Length of the matched substring in the prediction result text.
-          type: number
+          type: integer
         offset:
           description: Start location of the matched substring in the prediction result text.
-          type: number
+          type: integer
       example:
         offset: 0
         length: 4
@@ -4563,11 +4638,19 @@ components:
       title: AssetAutocompleteResponse
       type: object
       description: Asset Autocomplete Response with highlighted results on asset name.
+      required:
+        - predictions
       properties:
         predictions:
           description: A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)
           items:
             type: object
+            required:
+              - store_id
+              - name
+              - types
+              - matched_substrings
+              - highlighted
             properties:
               name:
                 description: |
@@ -4616,9 +4699,11 @@ components:
       title: BoundsResponse
       type: object
       description: Message returned to a success Search Bounds request
+      required:
+        - bounds
       properties:
         bounds:
-          description: The bounds object
+          description: The bounds object, empty when no asset matches.
           type: object
           properties:
             west:
diff --git a/specification/parameters/_index.yml b/specification/parameters/_index.yml
index 7e58172f..87ec8b85 100755
--- a/specification/parameters/_index.yml
+++ b/specification/parameters/_index.yml
@@ -22,8 +22,10 @@ search_lat:
   $ref: "./search/lat.yml"
 search_language:
   $ref: "./search/language.yml"
-search_encoded_polyline:
-  $ref: "./search/encoded_polyline.yml"
+search_polyline:
+  $ref: "./search/polyline.yml"
+search_bounds:
+  $ref: "./search/bounds.yml"
 geolocation_limit:
   $ref: "./geolocation/limit.yml"
 geolocation_ip_address:
diff --git a/specification/parameters/search/bounds.yml b/specification/parameters/search/bounds.yml
new file mode 100644
index 00000000..8331c81e
--- /dev/null
+++ b/specification/parameters/search/bounds.yml
@@ -0,0 +1,7 @@
+name: bounds
+description: >
+  Restricts the results to the Assets inside a bounding box, as `west,south,east,north` in decimal degrees. Takes precedence over `lat`/`lng` and `polyline`.
+schema:
+  type: string
+  example: "2.29,48.85,2.35,48.87"
+in: query
diff --git a/specification/parameters/search/lat.yml b/specification/parameters/search/lat.yml
index 8e3c6afb..938106e1 100644
--- a/specification/parameters/search/lat.yml
+++ b/specification/parameters/search/lat.yml
@@ -1,6 +1,6 @@
 name: lat
 description: >
-  Latitude bias for the results. Should be pass with `lng`.
+  Latitude bias for the results. Must be passed with `lng`.
 schema:
   type: number
   example: 5.2
diff --git a/specification/parameters/search/limit.yml b/specification/parameters/search/limit.yml
index 2c56b962..38df9fd3 100644
--- a/specification/parameters/search/limit.yml
+++ b/specification/parameters/search/limit.yml
@@ -5,5 +5,6 @@ schema:
   type: integer
   minimum: 1
   maximum: 50
+  default: 5
   example: 15
 in: query
\ No newline at end of file
diff --git a/specification/parameters/search/lng.yml b/specification/parameters/search/lng.yml
index 2a4132db..a2073500 100644
--- a/specification/parameters/search/lng.yml
+++ b/specification/parameters/search/lng.yml
@@ -1,6 +1,6 @@
 name: lng
 description: >
-  Longitude bias for the results. Should be pass with `lat`.
+  Longitude bias for the results. Must be passed with `lat`.
 schema:
   type: number
   example: 3.5
diff --git a/specification/parameters/search/page.yml b/specification/parameters/search/page.yml
index d3c684e1..a703363c 100644
--- a/specification/parameters/search/page.yml
+++ b/specification/parameters/search/page.yml
@@ -3,5 +3,7 @@ description: >
   Page number when accessing paginated assets feature collection
 schema:
   type: integer
+  minimum: 1
+  default: 1
   example: 2
 in: query
\ No newline at end of file
diff --git a/specification/parameters/search/encoded_polyline.yml b/specification/parameters/search/polyline.yml
similarity index 79%
rename from specification/parameters/search/encoded_polyline.yml
rename to specification/parameters/search/polyline.yml
index e23ee136..be93cfbb 100644
--- a/specification/parameters/search/encoded_polyline.yml
+++ b/specification/parameters/search/polyline.yml
@@ -1,6 +1,6 @@
-name: encoded_polyline
+name: polyline
 description: >
-  Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius.
+  Find assets nearby an [encoded polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) and inside a defined radius. Requires `radius`.
 schema:
   type: string
   example: '_p~iF~ps|U_ulLnnqC_mqNvxq`@'
diff --git a/specification/parameters/search/radius.yml b/specification/parameters/search/radius.yml
index 44ac823c..1bbe80e2 100644
--- a/specification/parameters/search/radius.yml
+++ b/specification/parameters/search/radius.yml
@@ -1,6 +1,6 @@
 name: radius
 description: >
-  Unit in meters. Used to combine with lat/lng or encoded polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline).
+  Unit in meters. Used to combine with lat/lng or polyline. To bias the results within a given circular area. 3000 means to search for Assets that are at the most far from 3kms to search area (latlng or polyline). Without `radius`, `lat`/`lng` only sort the Assets by distance.
 schema:
   type: number
   example: 3000
diff --git a/specification/parameters/search/stores_by_page.yml b/specification/parameters/search/stores_by_page.yml
index 63187fb0..778260f9 100644
--- a/specification/parameters/search/stores_by_page.yml
+++ b/specification/parameters/search/stores_by_page.yml
@@ -5,5 +5,6 @@ schema:
   type: integer
   minimum: 1
   maximum: 300
+  default: 100
   example: 150
 in: query
\ No newline at end of file
diff --git a/specification/parameters/zones/limit.yml b/specification/parameters/zones/limit.yml
index 9eeae8ed..3518433d 100644
--- a/specification/parameters/zones/limit.yml
+++ b/specification/parameters/zones/limit.yml
@@ -1,9 +1,10 @@
 name: limit
 description: >
-  To limit number of zones retrieved (max 50).
+  To limit number of zones retrieved (Default is 10, max is 50).
 schema:
   type: integer
   minimum: 1
   maximum: 50
+  default: 10
   example: 10
 in: query
diff --git a/specification/parameters/zones/offset.yml b/specification/parameters/zones/offset.yml
index 8424fefc..6504d33b 100644
--- a/specification/parameters/zones/offset.yml
+++ b/specification/parameters/zones/offset.yml
@@ -3,6 +3,7 @@ description: >
   To retrieve zones starting from an offset value.
 schema:
   type: integer
-  minimum: 1
+  minimum: 0
+  default: 0
   example: 20
 in: query
diff --git a/specification/paths/search/storesAutocomplete.yml b/specification/paths/search/storesAutocomplete.yml
index 1d17bb97..1731e2cf 100644
--- a/specification/paths/search/storesAutocomplete.yml
+++ b/specification/paths/search/storesAutocomplete.yml
@@ -5,6 +5,7 @@ tags:
 description: >
   Autocomplete on `localizedNames` with highlighted results on asset name.
   Use the field `localized` in your query parameter to search for localized names.
+  Without `query`, the response has no predictions.
 security:
   - PublicApiKeyAuth: []
     RefererHeader: []
diff --git a/specification/paths/search/storesSearch.yml b/specification/paths/search/storesSearch.yml
index 691af168..1cfc4640 100644
--- a/specification/paths/search/storesSearch.yml
+++ b/specification/paths/search/storesSearch.yml
@@ -14,7 +14,8 @@ parameters:
   - $ref: "../../parameters/search/lat.yml"
   - $ref: "../../parameters/search/lng.yml"
   - $ref: "../../parameters/search/radius.yml"
-  - $ref: "../../parameters/search/encoded_polyline.yml"
+  - $ref: "../../parameters/search/polyline.yml"
+  - $ref: "../../parameters/search/bounds.yml"
   - $ref: "../../parameters/search/stores_by_page.yml"
   - $ref: "../../parameters/search/page.yml"
   - $ref: "../../parameters/search/zone.yml"
diff --git a/specification/schemas/AssetAddressResponse.yml b/specification/schemas/AssetAddressResponse.yml
index e3beae25..cacaf270 100644
--- a/specification/schemas/AssetAddressResponse.yml
+++ b/specification/schemas/AssetAddressResponse.yml
@@ -1,20 +1,29 @@
 title: AssetAddressResponse
 type: object
 description: An object containing the separate components applicable to this address.
+required:
+  - lines
+  - country_code
+  - city
+  - zipcode
 properties:
   lines:
-    $ref: "./AssetAddressLines.yml"
+    description: An Array for lines of an Asset Address
+    type: [array, "null"]
+    items:
+      type: string
+    example: ["Building Centre", "26 Store Street"]
   country_code:
     description: An ISO_3166-1 Country Code where the Asset is located (see <https://en.wikipedia.org/wiki/ISO_3166-1> for full list)
     type: [string, "null"]
     example: "UK"
   city:
     description: A City where belongs an Asset
-    type: string
+    type: [string, "null"]
     example: "London"
   zipcode:
     description: An Zipcode / Postal code of an Asset Address
-    type: string
+    type: [string, "null"]
     example: "WC1E 7BT"
 example: {
   "lines": [
diff --git a/specification/schemas/AssetAutocompleteResponse.yml b/specification/schemas/AssetAutocompleteResponse.yml
index 156cc808..fe7b53ac 100644
--- a/specification/schemas/AssetAutocompleteResponse.yml
+++ b/specification/schemas/AssetAutocompleteResponse.yml
@@ -1,11 +1,19 @@
 title: AssetAutocompleteResponse
 type: object
 description: Asset Autocomplete Response with highlighted results on asset name.
+required:
+  - predictions
 properties:
   predictions:
     description: A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)
     items:
       type: object
+      required:
+        - store_id
+        - name
+        - types
+        - matched_substrings
+        - highlighted
       properties:
         name:
           description: >
diff --git a/specification/schemas/AssetFeatureCollectionResponse.yml b/specification/schemas/AssetFeatureCollectionResponse.yml
index 9d65a77f..001ed311 100644
--- a/specification/schemas/AssetFeatureCollectionResponse.yml
+++ b/specification/schemas/AssetFeatureCollectionResponse.yml
@@ -1,6 +1,10 @@
 title: AssetFeatureCollectionResponse
 type: object
 description: Assets Collection Response as a GeoJSon FeatureCollection with Asset properties
+required:
+  - type
+  - features
+  - pagination
 properties:
   type:
     description: the Geojson Type (only 'FeatureCollection')
diff --git a/specification/schemas/AssetFeatureResponse.yml b/specification/schemas/AssetFeatureResponse.yml
index 65e94645..f9fce1e6 100644
--- a/specification/schemas/AssetFeatureResponse.yml
+++ b/specification/schemas/AssetFeatureResponse.yml
@@ -1,6 +1,10 @@
 title: AssetFeatureResponse
 type: object
 description: Asset Response as a GeoJSon Feature with Asset properties
+required:
+  - type
+  - properties
+  - geometry
 properties:
   type:
     description: the Geojson Type (only 'Feature')
diff --git a/specification/schemas/AssetOpenResponse.yml b/specification/schemas/AssetOpenResponse.yml
index f1145261..eadc9e2d 100644
--- a/specification/schemas/AssetOpenResponse.yml
+++ b/specification/schemas/AssetOpenResponse.yml
@@ -1,6 +1,10 @@
 title: AssetOpenResponse
 type: object
 description: The Current opening status for an Asset
+required:
+  - open_now
+  - open_hours
+  - week_day
 properties:
   current_slice:
     $ref: "./AssetOpeningHoursPeriod.yml"
@@ -13,17 +17,22 @@ properties:
     description: Boolean value indicating the status of the opening hours
     type: boolean
   next_opening:
-    description: the next opening hours period
-    type: object
+    description: the next opening hours period, returned when the asset is closed. `null` when the asset does not open in the next days.
+    type: [object, "null"]
+    required:
+      - day
     properties:
       end:
-        description: the hours of next opening
+        description: the hours of next closing
         type: string
         example: "17:30"
       start:
-        description: the hours of next closing
+        description: the hours of next opening
         type: string
         example: "06:00"
+      all-day:
+        description: true when the asset is open all day, in place of `start` and `end`
+        type: boolean
       day:
         type: string
         description: the day of next opening
diff --git a/specification/schemas/AssetResponse.yml b/specification/schemas/AssetResponse.yml
index d0fff868..fbe7625c 100644
--- a/specification/schemas/AssetResponse.yml
+++ b/specification/schemas/AssetResponse.yml
@@ -1,6 +1,15 @@
 title: AssetResponse
 type: object
 description: Attributes describing an Asset.
+required:
+  - store_id
+  - name
+  - address
+  - contact
+  - types
+  - tags
+  - last_updated
+  - user_properties
 properties:
   name:
     $ref: "./AssetName.yml"
@@ -23,12 +32,18 @@ properties:
     description: the previous date timestamp when the asset has been updated
     example: "2022-11-08T15:48:08.556803+00:00"
   user_properties:
-    description: Contains all additional information relative to an Asset. If not set it returns null value.
-    type: [object, "null"]
+    description: Contains all additional information relative to an Asset. Empty object when not set.
+    type: object
     additionalProperties: true
     example: { "some_user_properties": "some_value" }
   opening_hours:
     $ref: "./AssetOpeningHours.yml"
+  localized_names:
+    description: Alternate names of the Asset, keyed by language. Only returned when set.
+    type: object
+    additionalProperties:
+      type: string
+    example: { "fr": "Centre Commercial Velizy", "it": "Centro Commerciale Velizy" }
   distance:
     description: The distance in meters from the geolocated position or searched position if exist
     type: number
diff --git a/specification/schemas/BoundsResponse.yml b/specification/schemas/BoundsResponse.yml
index 4b98247e..85393054 100644
--- a/specification/schemas/BoundsResponse.yml
+++ b/specification/schemas/BoundsResponse.yml
@@ -1,9 +1,11 @@
 title: BoundsResponse
 type: object
 description: Message returned to a success Search Bounds request
+required:
+  - bounds
 properties:
   bounds:
-    description: The bounds object
+    description: The bounds object, empty when no asset matches.
     type: object
     properties:
       west:
diff --git a/specification/schemas/GeoJsonPoint.yml b/specification/schemas/GeoJsonPoint.yml
index 8b02252d..fe9a5c40 100644
--- a/specification/schemas/GeoJsonPoint.yml
+++ b/specification/schemas/GeoJsonPoint.yml
@@ -1,6 +1,9 @@
 title: GeoJsonPoint
 type: object
 description: GeoJSon Point Geometry
+required:
+  - type
+  - coordinates
 properties:
   type:
     type: string
diff --git a/specification/schemas/MatchedSubstring.yml b/specification/schemas/MatchedSubstring.yml
index 209129d7..4cd1f0f9 100644
--- a/specification/schemas/MatchedSubstring.yml
+++ b/specification/schemas/MatchedSubstring.yml
@@ -1,10 +1,13 @@
 title: MatchedSubstring
 type: object
+required:
+  - offset
+  - length
 properties:
   length:
     description: Length of the matched substring in the prediction result text.
-    type: number
+    type: integer
   offset:
     description: Start location of the matched substring in the prediction result text.
-    type: number
+    type: integer
 example: { "offset": 0, length: 4 }
diff --git a/specification/schemas/Pagination.yml b/specification/schemas/Pagination.yml
index b1948b28..fbe1f5ef 100644
--- a/specification/schemas/Pagination.yml
+++ b/specification/schemas/Pagination.yml
@@ -1,6 +1,9 @@
 title: Pagination
 type: object
 description: Pagination to reach all returned assets. max 300 assets par page.
+required:
+  - page
+  - pageCount
 properties:
   page:
     type: integer

From f598151a6481f427fd3fa2029769899af2b72cf2 Mon Sep 17 00:00:00 2001
From: galela <gsimon@woosmap.com>
Date: Fri, 2 Oct 2026 12:35:25 +0200
Subject: [PATCH 2/2] fix(stores): type autocomplete predictions as an array

---
 ...tp_schema_assetautocompleteprediction.html | 142 ++++++++++++++++++
 ...http_schema_assetautocompleteprediction.md |  20 +++
 ...http_schema_assetautocompleteresponse.html |  17 ++-
 ...p_http_schema_assetautocompleteresponse.md |   6 +-
 dist/woosmap-openapi3.json                    |  70 +++++----
 dist/woosmap-openapi3.yml                     |  55 ++++---
 .../schemas/AssetAutocompletePrediction.yml   |  28 ++++
 .../schemas/AssetAutocompleteResponse.yml     |  28 +---
 specification/schemas/_index.yml              |   2 +
 9 files changed, 280 insertions(+), 88 deletions(-)
 create mode 100644 dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.html
 create mode 100644 dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.md
 create mode 100644 specification/schemas/AssetAutocompletePrediction.yml

diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.html b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.html
new file mode 100644
index 00000000..991dece4
--- /dev/null
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.html
@@ -0,0 +1,142 @@
+<!--- This is a generated file, do not edit! -->
+<!--- [START woosmap_http_schema_assetautocompleteprediction] -->
+<h3 class="schema-object" id="AssetAutocompletePrediction">
+  AssetAutocompletePrediction
+</h3>
+<p>An Asset matching the autocomplete query.</p>
+<table>
+  <thead>
+    <tr>
+      <th align="left">Field</th>
+      <th>Required</th>
+      <th>Type</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetAutocompletePrediction-highlighted"
+          class="add-link schema-object-property-key"
+        >
+          <code>highlighted</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td>string</td>
+      <td>
+        <div class="nonref-property-description">
+          <p>
+            an HTML formatted string with, if it exists, the matched
+            substring(s) in bold font.
+          </p>
+        </div>
+      </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetAutocompletePrediction-matched_substrings"
+          class="add-link schema-object-property-key"
+        >
+          <code>matched_substrings</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td>
+        Array&#x26;lt;<a href="#MatchedSubstring" title="MatchedSubstring"
+          >MatchedSubstring</a
+        >&#x26;gt;
+      </td>
+      <td>
+        See
+        <a href="#MatchedSubstring" title="MatchedSubstring"
+          >MatchedSubstring</a
+        >
+        for more information.
+      </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetAutocompletePrediction-name"
+          class="add-link schema-object-property-key"
+        >
+          <code>name</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td>string</td>
+      <td>
+        <div class="nonref-property-description">
+          <p>
+            The <code>name</code> property of each prediction will be filled
+            with the localized name of your asset in the
+            <code>language</code> you provided in your query if it exists, or
+            else the default name property.
+          </p>
+        </div>
+      </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetAutocompletePrediction-store_id"
+          class="add-link schema-object-property-key"
+        >
+          <code>store_id</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td><a href="#AssetId" title="AssetId">AssetId</a></td>
+      <td>
+        See <a href="#AssetId" title="AssetId">AssetId</a> for more information.
+      </td>
+    </tr>
+    <tr>
+      <td align="left">
+        <h4
+          id="AssetAutocompletePrediction-types"
+          class="add-link schema-object-property-key"
+        >
+          <code>types</code>
+        </h4>
+      </td>
+      <td><strong>required</strong></td>
+      <td><a href="#AssetTypes" title="AssetTypes">AssetTypes</a></td>
+      <td>
+        See <a href="#AssetTypes" title="AssetTypes">AssetTypes</a> for more
+        information.
+      </td>
+    </tr>
+  </tbody>
+</table>
+<p style="text-align: right; font-size: smaller">
+  Generated from the
+  <a
+    data-label="openapi-github"
+    href="https://github.com/woosmap/openapi-specification"
+    title="Woosmap OpenAPI Specification"
+    class="external"
+    >OpenAPI specification</a
+  >.
+  <a
+    data-label="openapi-github-woosmap-http-schema-assetautocompleteprediction"
+    data-action="edit"
+    style="margin-left: 5px"
+    href="https://github.com/woosmap/openapi-specification/blob/main/specification/schemas/AssetAutocompletePrediction.yml"
+    title="Edit on GitHub"
+    >✎ Edit</a
+  >
+  <a
+    data-label="openapi-github-woosmap-http-schema-assetautocompleteprediction"
+    data-action="bug"
+    style="margin-left: 5px"
+    href="https://github.com/woosmap/openapi-specification/issues/new?assignees=&labels=type%3A+bug%2C+triage+me&template=bug_report.md&title=[schemas] Bug - AssetAutocompletePrediction"
+    title="File bug for schemas on GitHub"
+    ><span class="material-icons">bug_report</span> Report bug</a
+  >
+</p>
+
+<!--- [END woosmap_http_schema_assetautocompleteprediction] -->
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.md b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.md
new file mode 100644
index 00000000..84edd0ba
--- /dev/null
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteprediction.md
@@ -0,0 +1,20 @@
+<!--- This is a generated file, do not edit! -->
+<!--- [START woosmap_http_schema_assetautocompleteprediction] -->
+<h3 class="schema-object" id="AssetAutocompletePrediction">AssetAutocompletePrediction</h3>
+
+An Asset matching the autocomplete query.
+
+| Field                                                                                                                                    | Required     | Type                                                                    | Description                                                                                                                                                                                                                                                           |
+| :--------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetAutocompletePrediction-highlighted" class="add-link schema-object-property-key"><code>highlighted</code></h4>               | **required** | string                                                                  | <div class="nonref-property-description"><p>an HTML formatted string with, if it exists, the matched substring(s) in bold font.</p></div>                                                                                                                             |
+| <h4 id="AssetAutocompletePrediction-matched_substrings" class="add-link schema-object-property-key"><code>matched_substrings</code></h4> | **required** | Array\&lt;[MatchedSubstring](#MatchedSubstring "MatchedSubstring")\&gt; | See [MatchedSubstring](#MatchedSubstring "MatchedSubstring") for more information.                                                                                                                                                                                    |
+| <h4 id="AssetAutocompletePrediction-name" class="add-link schema-object-property-key"><code>name</code></h4>                             | **required** | string                                                                  | <div class="nonref-property-description"><p>The <code>name</code> property of each prediction will be filled with the localized name of your asset in the <code>language</code> you provided in your query if it exists, or else the default name property.</p></div> |
+| <h4 id="AssetAutocompletePrediction-store_id" class="add-link schema-object-property-key"><code>store_id</code></h4>                     | **required** | [AssetId](#AssetId "AssetId")                                           | See [AssetId](#AssetId "AssetId") for more information.                                                                                                                                                                                                               |
+| <h4 id="AssetAutocompletePrediction-types" class="add-link schema-object-property-key"><code>types</code></h4>                           | **required** | [AssetTypes](#AssetTypes "AssetTypes")                                  | See [AssetTypes](#AssetTypes "AssetTypes") for more information.                                                                                                                                                                                                      |
+
+<p style="text-align: right; font-size: smaller;">Generated from the <a data-label="openapi-github" href="https://github.com/woosmap/openapi-specification" title="Woosmap OpenAPI Specification" class="external">OpenAPI specification</a>.
+<a data-label="openapi-github-woosmap-http-schema-assetautocompleteprediction" data-action="edit" style="margin-left: 5px;" href="https://github.com/woosmap/openapi-specification/blob/main/specification/schemas/AssetAutocompletePrediction.yml" title="Edit on GitHub">✎ Edit</a>
+<a data-label="openapi-github-woosmap-http-schema-assetautocompleteprediction" data-action="bug" style="margin-left: 5px;" href="https://github.com/woosmap/openapi-specification/issues/new?assignees=&labels=type%3A+bug%2C+triage+me&template=bug_report.md&title=[schemas] Bug - AssetAutocompletePrediction" title="File bug for schemas on GitHub"><span class="material-icons">bug_report</span> Report bug</a>
+</p>
+
+<!--- [END woosmap_http_schema_assetautocompleteprediction] -->
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
index 6045a980..a980298a 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.html
@@ -24,14 +24,27 @@ <h3 class="schema-object" id="AssetAutocompleteResponse">
         </h4>
       </td>
       <td><strong>required</strong></td>
-      <td></td>
       <td>
-        <div class="nonref-property-description">
+        Array&#x26;lt;<a
+          href="#AssetAutocompletePrediction"
+          title="AssetAutocompletePrediction"
+          >AssetAutocompletePrediction</a
+        >&#x26;gt;
+      </td>
+      <td>
+        <div class="ref-property-description">
           <p>
             A list of predictions based on similarity in all the
             <code>localizedNames</code> passed in query (or similarity to
             <code>store_name</code> if no <code>localizedNames</code> exist)
           </p>
+          <p>
+            See
+            <a href="#AssetAutocompletePrediction"
+              >AssetAutocompletePrediction</a
+            >
+            for more information.
+          </p>
         </div>
       </td>
     </tr>
diff --git a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
index 310a45d9..d02359bc 100644
--- a/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
+++ b/dist/documentation/schemas/woosmap_http_schema_assetautocompleteresponse.md
@@ -4,9 +4,9 @@
 
 Asset Autocomplete Response with highlighted results on asset name.
 
-| Field                                                                                                                    | Required     | Type | Description                                                                                                                                                                                                                               |
-| :----------------------------------------------------------------------------------------------------------------------- | ------------ | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <h4 id="AssetAutocompleteResponse-predictions" class="add-link schema-object-property-key"><code>predictions</code></h4> | **required** |      | <div class="nonref-property-description"><p>A list of predictions based on similarity in all the <code>localizedNames</code> passed in query (or similarity to <code>store_name</code> if no <code>localizedNames</code> exist)</p></div> |
+| Field                                                                                                                    | Required     | Type                                                                                                     | Description                                                                                                                                                                                                                                                                                                                               |
+| :----------------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="AssetAutocompleteResponse-predictions" class="add-link schema-object-property-key"><code>predictions</code></h4> | **required** | Array\&lt;[AssetAutocompletePrediction](#AssetAutocompletePrediction "AssetAutocompletePrediction")\&gt; | <div class="ref-property-description"><p>A list of predictions based on similarity in all the <code>localizedNames</code> passed in query (or similarity to <code>store_name</code> if no <code>localizedNames</code> exist)</p><p>See <a href="#AssetAutocompletePrediction">AssetAutocompletePrediction</a> for more information.</div> |
 
 <h4 class="schema-object-example" id="AssetAutocompleteResponse-example">Example</h4>
 
diff --git a/dist/woosmap-openapi3.json b/dist/woosmap-openapi3.json
index 3eac1e1f..bb670b12 100755
--- a/dist/woosmap-openapi3.json
+++ b/dist/woosmap-openapi3.json
@@ -4990,6 +4990,42 @@
           "length": 4
         }
       },
+      "AssetAutocompletePrediction": {
+        "title": "AssetAutocompletePrediction",
+        "type": "object",
+        "description": "An Asset matching the autocomplete query.",
+        "required": [
+          "store_id",
+          "name",
+          "types",
+          "matched_substrings",
+          "highlighted"
+        ],
+        "properties": {
+          "name": {
+            "description": "The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists, or else the default name property.\n",
+            "type": "string",
+            "example": "Centro Commerciale Deria"
+          },
+          "highlighted": {
+            "type": "string",
+            "description": "an HTML formatted string with, if it exists, the matched substring(s) in bold font.",
+            "example": "Centro <b>Commercial</b>e Deria"
+          },
+          "store_id": {
+            "$ref": "#/components/schemas/AssetId"
+          },
+          "types": {
+            "$ref": "#/components/schemas/AssetTypes"
+          },
+          "matched_substrings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchedSubstring"
+            }
+          }
+        }
+      },
       "AssetAutocompleteResponse": {
         "title": "AssetAutocompleteResponse",
         "type": "object",
@@ -5000,39 +5036,9 @@
         "properties": {
           "predictions": {
             "description": "A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)",
+            "type": "array",
             "items": {
-              "type": "object",
-              "required": [
-                "store_id",
-                "name",
-                "types",
-                "matched_substrings",
-                "highlighted"
-              ],
-              "properties": {
-                "name": {
-                  "description": "The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists, or else the default name property.\n",
-                  "type": "string",
-                  "example": "Centro Commerciale Deria"
-                },
-                "highlighted": {
-                  "type": "string",
-                  "description": "an HTML formatted string with, if it exists, the matched substring(s) in bold font.",
-                  "example": "Centro <b>Commercial</b>e Deria"
-                },
-                "store_id": {
-                  "$ref": "#/components/schemas/AssetId"
-                },
-                "types": {
-                  "$ref": "#/components/schemas/AssetTypes"
-                },
-                "matched_substrings": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/MatchedSubstring"
-                  }
-                }
-              }
+              "$ref": "#/components/schemas/AssetAutocompletePrediction"
             }
           }
         },
diff --git a/dist/woosmap-openapi3.yml b/dist/woosmap-openapi3.yml
index 7b38b6f9..c394bd54 100755
--- a/dist/woosmap-openapi3.yml
+++ b/dist/woosmap-openapi3.yml
@@ -4634,6 +4634,34 @@ components:
       example:
         offset: 0
         length: 4
+    AssetAutocompletePrediction:
+      title: AssetAutocompletePrediction
+      type: object
+      description: An Asset matching the autocomplete query.
+      required:
+        - store_id
+        - name
+        - types
+        - matched_substrings
+        - highlighted
+      properties:
+        name:
+          description: |
+            The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists, or else the default name property.
+          type: string
+          example: Centro Commerciale Deria
+        highlighted:
+          type: string
+          description: an HTML formatted string with, if it exists, the matched substring(s) in bold font.
+          example: Centro <b>Commercial</b>e Deria
+        store_id:
+          $ref: '#/components/schemas/AssetId'
+        types:
+          $ref: '#/components/schemas/AssetTypes'
+        matched_substrings:
+          type: array
+          items:
+            $ref: '#/components/schemas/MatchedSubstring'
     AssetAutocompleteResponse:
       title: AssetAutocompleteResponse
       type: object
@@ -4643,32 +4671,9 @@ components:
       properties:
         predictions:
           description: A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)
+          type: array
           items:
-            type: object
-            required:
-              - store_id
-              - name
-              - types
-              - matched_substrings
-              - highlighted
-            properties:
-              name:
-                description: |
-                  The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists, or else the default name property.
-                type: string
-                example: Centro Commerciale Deria
-              highlighted:
-                type: string
-                description: an HTML formatted string with, if it exists, the matched substring(s) in bold font.
-                example: Centro <b>Commercial</b>e Deria
-              store_id:
-                $ref: '#/components/schemas/AssetId'
-              types:
-                $ref: '#/components/schemas/AssetTypes'
-              matched_substrings:
-                type: array
-                items:
-                  $ref: '#/components/schemas/MatchedSubstring'
+            $ref: '#/components/schemas/AssetAutocompletePrediction'
       example:
         predictions:
           - store_id: '2670'
diff --git a/specification/schemas/AssetAutocompletePrediction.yml b/specification/schemas/AssetAutocompletePrediction.yml
new file mode 100644
index 00000000..418f32f0
--- /dev/null
+++ b/specification/schemas/AssetAutocompletePrediction.yml
@@ -0,0 +1,28 @@
+title: AssetAutocompletePrediction
+type: object
+description: An Asset matching the autocomplete query.
+required:
+  - store_id
+  - name
+  - types
+  - matched_substrings
+  - highlighted
+properties:
+  name:
+    description: >
+      The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists,
+      or else the default name property.
+    type: string
+    example: "Centro Commerciale Deria"
+  highlighted:
+    type: string
+    description: an HTML formatted string with, if it exists, the matched substring(s) in bold font.
+    example: "Centro <b>Commercial</b>e Deria"
+  store_id:
+    $ref: "./AssetId.yml"
+  types:
+    $ref: "./AssetTypes.yml"
+  matched_substrings:
+    type: array
+    items:
+      $ref: "./MatchedSubstring.yml"
diff --git a/specification/schemas/AssetAutocompleteResponse.yml b/specification/schemas/AssetAutocompleteResponse.yml
index fe7b53ac..e34299a7 100644
--- a/specification/schemas/AssetAutocompleteResponse.yml
+++ b/specification/schemas/AssetAutocompleteResponse.yml
@@ -6,32 +6,8 @@ required:
 properties:
   predictions:
     description: A list of predictions based on similarity in all the `localizedNames` passed in query (or similarity to `store_name` if no `localizedNames` exist)
+    type: array
     items:
-      type: object
-      required:
-        - store_id
-        - name
-        - types
-        - matched_substrings
-        - highlighted
-      properties:
-        name:
-          description: >
-            The `name` property of each prediction will be filled with the localized name of your asset in the `language` you provided in your query if it exists,
-            or else the default name property.
-          type: string
-          example: "Centro Commerciale Deria"
-        highlighted:
-          type: string
-          description: an HTML formatted string with, if it exists, the matched substring(s) in bold font.
-          example: "Centro <b>Commercial</b>e Deria"
-        store_id:
-          $ref: "./AssetId.yml"
-        types:
-          $ref: "./AssetTypes.yml"
-        matched_substrings:
-          type: array
-          items:
-            $ref: "./MatchedSubstring.yml"
+      $ref: "./AssetAutocompletePrediction.yml"
 example:
   $ref: "../responses/woosmap_http_asset_autocomplete_feature_collection_response.yml"
diff --git a/specification/schemas/_index.yml b/specification/schemas/_index.yml
index 622e6a7f..712a30b3 100644
--- a/specification/schemas/_index.yml
+++ b/specification/schemas/_index.yml
@@ -16,6 +16,8 @@ AssetFeatureCollectionResponse:
   $ref: "./AssetFeatureCollectionResponse.yml"
 AssetAutocompleteResponse:
   $ref: "./AssetAutocompleteResponse.yml"
+AssetAutocompletePrediction:
+  $ref: "./AssetAutocompletePrediction.yml"
 Pagination:
   $ref: "./Pagination.yml"
 MatchedSubstring: