> For the complete documentation index, see [llms.txt](https://docs.spurtcommerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spurtcommerce.com/api-reference/store/store-content/navigation-and-widgets.md).

# Navigation And Widgets

Retrieve storefront banners, widgets and navigation data.

## Get the active Store banner for a named placement.

> Get the active Store banner for a named placement.\
> \
> \*\*Authentication:\*\* Public; tenant validation applies.\
> \
> \*\*Feature area:\*\* Store content\
> \
> \*\*Implementation source:\*\* \`src/api/store/controllers/CommonListController.ts\`\
> \
> \*\*Request example provenance:\*\* Response keys and success/error messages follow the source handler; values are illustrative.\
> \
> \*\*Response example provenance:\*\* Response keys and success/error messages follow the source handler; values are illustrative.\
> \
> \> \*\*Example status: Illustrative.\*\* The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.

```json
{"openapi":"3.0.3","info":{"title":"SpurtCommerce Store API","version":"6.0.0"},"tags":[{"name":"Navigation and widgets","description":"Retrieve storefront banners, widgets and navigation data."}],"servers":[{"url":"https://api.example.com","description":"Replace with your SpurtCommerce API host. Paths include the /api prefix."}],"paths":{"/api/store-list/banner/position/{position}":{"get":{"operationId":"getApiStoreListBannerPositionPosition","summary":"Get the active Store banner for a named placement.","description":"Get the active Store banner for a named placement.\n\n**Authentication:** Public; tenant validation applies.\n\n**Feature area:** Store content\n\n**Implementation source:** `src/api/store/controllers/CommonListController.ts`\n\n**Request example provenance:** Response keys and success/error messages follow the source handler; values are illustrative.\n\n**Response example provenance:** Response keys and success/error messages follow the source handler; values are illustrative.\n\n> **Example status: Illustrative.** The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.","tags":["Navigation and widgets"],"parameters":[{"name":"position","in":"path","required":true,"schema":{"type":"string"},"description":"Value for position."}],"responses":{"200":{"description":"Successful response. Response keys and success/error messages follow the source handler; values are illustrative. Example is illustrative and does not guarantee a stable response contract.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","properties":{"bannerId":{"type":"integer"},"title":{"type":"string"},"link":{"type":"string"},"content":{"type":"string"},"position":{"type":"string"},"image":{"type":"string"},"imagePath":{"type":"string"},"isActive":{"type":"integer"},"linkType":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true}}}},"400":{"description":"Error response example. Response keys and success/error messages follow the source handler; values are illustrative.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"integer"},"message":{"type":"string"}},"additionalProperties":true}}}}}}}}}
```