> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/commerce-openapis/admin/special-pages/list-special-pages-detailed.md).

# List special pages (detailed)

Returns the same paginated list as `GET /special_pages/`, with the same filters and ordering, but each page carries its product collection as a nested object. The detailed representation does not include `pretty_url`.

Translatable fields are always returned in the default language; the language selected for the request is not applied.

```json
{"openapi":"3.1.0","info":{"title":"Admin API","version":"1.0.0"},"tags":[{"name":"Special Pages","description":"Administrative endpoints for **special pages** — storefront pages that list the products of a single product collection under their own URL, optionally with a desktop and a mobile banner, a banner link, a description and an embedded video. They are typically used for campaign or brand pages.\n\nEvery active special page is reachable on the storefront through a **pretty URL** that is generated from the page's `url`. The pretty URL is created, updated and removed automatically as the page is created, changed, deactivated and deleted; it is returned read-only in the `pretty_url` field.\n\n## Core Capabilities\n\n**1. Special Page Listing & Filtering**\n* Retrieve a paginated list of special pages, active and inactive alike.\n* Filter by name, URL, template, product collection name, active state, product extraction strategy and creation / modification date.\n* Order results with the `sort` parameter.\n\n**2. Special Page Retrieval**\n* Retrieve a single special page.\n* The `/detailed/` variants of the list and retrieve operations return the product collection as a nested object instead of its identifier.\n\n**3. Special Page Management**\n* Create a special page; its pretty URL is generated in the same request.\n* Fully or partially update a special page; the pretty URL follows the new `url`.\n* Deactivate a special page by setting `is_active` to `false`, which also removes its pretty URL.\n* Delete a special page. Deleting is a **soft delete** — the record is kept and marked inactive.\n\n## URL Uniqueness\n\nA create request is rejected with `406` (`special_page_200`) when another special page already uses the same `url`, or when another pretty URL already has that path. The comparison ignores leading and trailing slashes, so `/summer-sale` and `/summer-sale/` are treated as the same path.\n\nTurkish characters (`ç`, `ğ`, `ı`, `İ`, `ö`, `ş`, `ü` and their capitals) are not accepted in `url`.\n\n## Deactivation & Deletion\n\n* Setting `is_active` to `false` on an active page removes its pretty URL; the response then returns `pretty_url` as `null`. Setting it back to `true` generates a new pretty URL.\n* `DELETE` marks the page inactive and removes its pretty URL. The record itself stays in the database and is still returned by the list and retrieve operations.\n\n> **Warning:** A special page that still has a pretty URL cannot be deleted directly — the request is rejected with `406` and the page stays active. Deleting the pretty URL on its own is rejected in the same way. Deactivate the page first with a partial update (`{\"is_active\": false}`), which removes the pretty URL, and then send the `DELETE` request.\n\n## Product Extraction Strategy\n\n`extraction_strategy` decides which variant of a product is shown in the storefront listing of the special page. It must be included in create and full-update requests, but may be `null`; a `null` value means the site-wide default is used (see `SPECIAL_PAGE_EXTRACTION_STRATEGY` under **Dynamic Settings & Environment Variables**).\n\nA request may send either the short name or the full value of a strategy; responses always return the full value.\n\n| Short name | Full value | Behavior |\n|------------|------------|----------|\n| `default` | `omnishop.search.strategies.DefaultProductExtractionStrategy` | Default |\n| `first_item` | `omnishop.search.strategies.FirstItemSearchExtractionStrategy` | First Variant |\n| `listable_first` | `omnishop.search.strategies.ListableFirstProductExtractionStrategy` | Listable Variant First |\n| `min_price_first` | `omnishop.search.strategies.MinPriceFirstProductExtractionStrategy` | Min Price Variant First |\n| `max_price_first` | `omnishop.search.strategies.MaxPriceFirstProductExtractionStrategy` | Max Price Variant First |\n| `all_sub_products` | `omnishop.search.strategies.AllSubProductsExtractionStrategy` | All Sub Products |\n| `offer_product` | `omnishop.search.strategies.OfferProductExtractionStrategy` | Offer Product |\n| `product_sorting_item` | `omnishop.search.strategies.ProductSortingItemExtractionStrategy` | Product Sorting Item |\n\nAny other value is rejected with `400` (`No matching type.`).\n\n## Translations\n\nThe fields `name`, `banner`, `banner_mobile`, `banner_url`, `banner_description` and `video_embedded_code` are translatable. They are written to, and read from, the language selected for the request:\n\n* In the default language (`LANGUAGE_CODE`) the values are stored on the page itself.\n* In any other configured language they are stored as a translation of the page; the default-language values are left unchanged. When no translation exists for the requested language, the default-language value is returned.\n\nThe remaining fields (`url`, `template`, `product_collection`, `is_active`, `extraction_strategy`) are shared by all languages. Whether the `Accept-Language` header can select the request language is controlled by `IGNORE_ACCEPT_LANGUAGE_HEADER`.\n\nTwo exceptions apply regardless of the request language:\n\n* The `/detailed/` operations always return the default-language values.\n* Filters match against the default-language values.\n\n## Language-Specific URLs\n\nOn multi-language sites (`PRETTY_URL_MULTI_LANGUAGE` on), `specialpageprettyurl_set` holds a separate URL of the page for each additional language:\n\n* The field is **required** on create and full update; an empty list is accepted.\n* Each item carries a `language` and a `url`. The default language cannot be used — its URL is the page's own `url` — and is rejected with `406` (`special_page_100`).\n* There is at most one URL per language. Sending a language that already has a URL replaces it; languages that are not included in the request are left unchanged.\n* The items are not applied in a request that deactivates the page.\n\nOn single-language sites the field is optional and any value sent is ignored.\n\n## Images\n\n`banner` and `banner_mobile` are image uploads, so requests that set them are sent as `multipart/form-data`. In a multipart request, send the items of `specialpageprettyurl_set` as indexed fields — `specialpageprettyurl_set[0]url`, `specialpageprettyurl_set[0]language`, and so on — and send an empty `extraction_strategy` for `null`. Sending `null` for an image in a JSON request removes it.\n\n## Filtering & Ordering\n\n| Parameter | Match | Notes |\n|-----------|-------|-------|\n| `name`, `url`, `template`, `banner_url`, `video_embedded_code` | Case-insensitive partial match | Send `NULL_VALUE` to return only pages where the field is empty, or `NOT_NULL_VALUE` for pages where it is set. |\n| `extraction_strategy` | Case-insensitive partial match on the full value | `?extraction_strategy=ListableFirst` matches `omnishop.search.strategies.ListableFirstProductExtractionStrategy`; the short name (`listable_first`) does not match. `NULL_VALUE` / `NOT_NULL_VALUE` select pages without / with an explicit strategy. |\n| `product_collection` | Case-insensitive partial match on the **collection name** | Not the collection identifier. |\n| `banner_description` | Exact | |\n| `is_active` | Exact | `true` or `false`. |\n| `pretty_url` | Exact | Identifier of a pretty URL. An identifier that does not exist is rejected with `400`. |\n| `created_date`, `modified_date` | Exact, plus the `__gt`, `__gte`, `__lt` and `__lte` suffixes | Values must be full ISO 8601 date-times (for example `2026-01-01T00:00:00`); a date without a time is rejected with `400`. |\n\nParameters that are not listed here are ignored. Use the `sort` query parameter to order the results; prefix with `-` for descending.\n\n## Dynamic Settings & Environment Variables\n\n**Dynamic settings** (`dj_dynamic_settings`):\n\n| Key | Type | Default | Effect |\n|-----|------|---------|--------|\n| `IGNORE_ACCEPT_LANGUAGE_HEADER` | boolean | `true` | Whether the `Accept-Language` header is discarded before the request is processed. While it is `true`, the header is honored only when the request also carries an `X-Omnitron-Session` header; otherwise the default language is used. Affects **every** operation: the selected language decides which translation of the translatable fields is written by create and update requests and returned by list and retrieve requests (see **Translations**). |\n| `SPECIAL_PAGE_EXTRACTION_STRATEGY` | string, one of the full strategy values listed under **Product Extraction Strategy** | `omnishop.search.strategies.DefaultProductExtractionStrategy` (or the `SPECIAL_PAGE_EXTRACTION_STRATEGY` Django setting when defined) | The strategy the storefront uses for pages whose `extraction_strategy` is `null`. It does not change the responses of these endpoints — a page without its own strategy is still returned with `extraction_strategy: null`. |\n\n**Environment variables / Django settings:**\n\n| Setting | Default | Effect |\n|---------|---------|--------|\n| `PRETTY_URL_MULTI_LANGUAGE` | `false` (read from the environment variable of the same name) | Enables language-specific URLs. When on, `specialpageprettyurl_set` is required on create and full update; when off, it is optional and ignored. See **Language-Specific URLs**. |\n| `LANGUAGE_CODE` | `tr-tr` | The default language. Translatable fields written in this language are stored on the page itself, and this language cannot be used in `specialpageprettyurl_set`. |\n| `LANGUAGES` | `tr-tr` only | The languages the site supports. A language that is not listed here cannot be selected for a request, so translations for it cannot be written or read. |"}],"servers":[{"description":"Omnitron Remote Proxy (external access — recommended)","url":"https://{omnitron_url}/api/v1/remote/{channel_id}","variables":{"omnitron_url":{"default":"sandbox.akinon.com","description":"Omnitron server URL (e.g., {omnitron.akinon.com})"},"channel_id":{"default":"1","description":"The channel identifier the remote request is routed through"}}},{"description":"Commerce API Server (internal / direct access only)","url":"https://{commerce_url}/api/v1","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Internal commerce server URL, reachable only from within the Omnitron network"}}}],"security":[{"tokenAuth":[]}],"components":{"securitySchemes":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token credential sent in the Authorization header, in the form: `Token <your-token>`. Requires a staff (admin) account."}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"The page number to return.","schema":{"type":"integer","default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"The number of items to return per page.","schema":{"type":"integer","default":10}},"sort":{"name":"sort","in":"query","required":false,"description":"Orders the results by one or more fields. Separate multiple fields with commas. Prefix a field with a hyphen (`-`) for descending order.","schema":{"type":"string"}},"specialPageNameFilter":{"name":"name","in":"query","required":false,"description":"Filter by name. Case-insensitive partial match against the default-language name. Send `NULL_VALUE` / `NOT_NULL_VALUE` to select pages where the field is empty / set.","schema":{"type":"string"}},"specialPageUrlFilter":{"name":"url","in":"query","required":false,"description":"Filter by URL. Case-insensitive partial match — `?url=sale` matches `/summer-sale/`.","schema":{"type":"string"}},"specialPageTemplateFilter":{"name":"template","in":"query","required":false,"description":"Filter by template. Case-insensitive partial match. Send `NULL_VALUE` / `NOT_NULL_VALUE` to select pages without / with a template.","schema":{"type":"string"}},"specialPageBannerUrlFilter":{"name":"banner_url","in":"query","required":false,"description":"Filter by banner link. Case-insensitive partial match. Send `NULL_VALUE` / `NOT_NULL_VALUE` to select pages without / with a banner link.","schema":{"type":"string"}},"specialPageVideoEmbeddedCodeFilter":{"name":"video_embedded_code","in":"query","required":false,"description":"Filter by embedded video code. Case-insensitive partial match. Send `NULL_VALUE` / `NOT_NULL_VALUE` to select pages without / with a video.","schema":{"type":"string"}},"specialPageExtractionStrategyFilter":{"name":"extraction_strategy","in":"query","required":false,"description":"Filter by product extraction strategy. Case-insensitive partial match against the **full** strategy value — `?extraction_strategy=ListableFirst` matches, the short name `listable_first` does not. Send `NULL_VALUE` / `NOT_NULL_VALUE` to select pages that use the site-wide default / their own strategy.","schema":{"type":"string"}},"specialPageProductCollectionFilter":{"name":"product_collection","in":"query","required":false,"description":"Filter by the **name** of the product collection. Case-insensitive partial match; the collection identifier is not accepted.","schema":{"type":"string"}},"specialPageBannerDescriptionFilter":{"name":"banner_description","in":"query","required":false,"description":"Filter by banner description. Exact match.","schema":{"type":"string"}},"specialPageIsActiveFilter":{"name":"is_active","in":"query","required":false,"description":"Filter by active state. Deleted pages are inactive, so `?is_active=true` excludes them.","schema":{"type":"boolean"}},"specialPagePrettyUrlFilter":{"name":"pretty_url","in":"query","required":false,"description":"Filter by the identifier of the page's pretty URL. An identifier that does not exist is rejected with `400`.","schema":{"type":"integer"}},"specialPageCreatedDateFilter":{"name":"created_date","in":"query","required":false,"description":"Filter by creation date-time. Exact match; the `created_date__gt`, `created_date__gte`, `created_date__lt` and `created_date__lte` variants are also supported. Values must be full ISO 8601 date-times (for example `2026-01-01T00:00:00`); a date without a time is rejected with `400`.","schema":{"type":"string","format":"date-time"}},"specialPageModifiedDateFilter":{"name":"modified_date","in":"query","required":false,"description":"Filter by last modification date-time. Exact match; the `modified_date__gt`, `modified_date__gte`, `modified_date__lt` and `modified_date__lte` variants are also supported. Values must be full ISO 8601 date-times; a date without a time is rejected with `400`.","schema":{"type":"string","format":"date-time"}}},"schemas":{"PaginatedSpecialPageDetailedList":{"type":"object","description":"A paginated list of special pages in the detailed representation.","properties":{"count":{"type":"integer","description":"Total number of special pages matching the request."},"next":{"type":["string","null"],"format":"uri","description":"URL of the next page, or `null` if this is the last page."},"previous":{"type":["string","null"],"format":"uri","description":"URL of the previous page, or `null` if this is the first page."},"results":{"type":"array","description":"The special pages on the current page.","items":{"$ref":"#/components/schemas/SpecialPageDetailed"}}}},"SpecialPageDetailed":{"type":"object","description":"The detailed representation of a special page. It carries the product collection as a nested object and does not include `pretty_url`. Translatable fields are always in the default language.","properties":{"pk":{"type":"integer","description":"The unique identifier of the special page."},"name":{"type":"string","description":"The default-language name of the page."},"url":{"type":"string","description":"The URL of the page."},"template":{"type":["string","null"],"description":"The storefront template used to render the page."},"banner":{"type":["string","null"],"format":"uri","description":"URL of the default-language desktop banner image."},"banner_mobile":{"type":["string","null"],"format":"uri","description":"URL of the default-language mobile banner image."},"banner_url":{"type":["string","null"],"description":"The default-language banner link."},"product_collection":{"$ref":"#/components/schemas/SpecialPageProductCollection"},"banner_description":{"type":["string","null"],"description":"The default-language banner text."},"is_active":{"type":"boolean","description":"Whether the page is active."},"created_date":{"type":"string","format":"date-time"},"modified_date":{"type":"string","format":"date-time"},"video_embedded_code":{"type":["string","null"],"description":"The default-language video embed code."},"specialpageprettyurl_set":{"type":"array","description":"The URLs of the page in additional languages.","items":{"$ref":"#/components/schemas/SpecialPageLanguageUrl"}},"extraction_strategy":{"$ref":"#/components/schemas/SpecialPageExtractionStrategy"}}},"SpecialPageProductCollection":{"type":"object","description":"The product collection whose products the page lists, as returned by the detailed operations.","properties":{"pk":{"type":"integer","description":"The unique identifier of the product collection."},"uuid":{"type":"string","format":"uuid","description":"The universally unique identifier of the product collection."},"name":{"type":"string","description":"The name of the product collection."},"slug":{"type":"string","description":"The slug of the product collection."},"is_active":{"type":"boolean","description":"Whether the product collection is active."},"created_date":{"type":"string","format":"date-time"},"modified_date":{"type":"string","format":"date-time"},"sort_option":{"type":["integer","null"],"description":"The identifier of the sort option applied to the collection, or `null`."},"collection_type":{"type":["string","null"],"enum":["static","dynamic",null],"description":"Whether the collection's products are assigned manually (`static`) or by rules (`dynamic`)."}}},"SpecialPageLanguageUrl":{"type":"object","description":"The URL of the page in one additional language. Used only on multi-language sites (`PRETTY_URL_MULTI_LANGUAGE` on).","required":["url","language"],"properties":{"pk":{"type":"integer","readOnly":true,"description":"The unique identifier of the language-specific URL."},"url":{"type":"string","maxLength":512,"description":"The URL of the page in this language. Turkish characters are not accepted."},"language":{"type":"string","maxLength":10,"description":"The language code, one of the languages configured for the site. The default language (`LANGUAGE_CODE`) is rejected with `406` (`special_page_100`)."}}},"SpecialPageExtractionStrategy":{"type":["string","null"],"description":"The product extraction strategy of the page, returned as its full value. `null` means the site-wide default (`SPECIAL_PAGE_EXTRACTION_STRATEGY`) is used. See **Product Extraction Strategy** in the Special Pages section.","enum":["omnishop.search.strategies.DefaultProductExtractionStrategy","omnishop.search.strategies.FirstItemSearchExtractionStrategy","omnishop.search.strategies.ListableFirstProductExtractionStrategy","omnishop.search.strategies.MinPriceFirstProductExtractionStrategy","omnishop.search.strategies.MaxPriceFirstProductExtractionStrategy","omnishop.search.strategies.AllSubProductsExtractionStrategy","omnishop.search.strategies.OfferProductExtractionStrategy","omnishop.search.strategies.ProductSortingItemExtractionStrategy",null]},"ValidationError":{"type":"object","description":"Returned when the request contains invalid or missing data. Errors are grouped by the field they apply to: each key is the name of a field from the request and its value is a list of one or more messages describing what is wrong with that field. Messages that do not belong to any single field are grouped under `non_field_errors`.","properties":{"non_field_errors":{"type":"array","description":"Error messages that apply to the request as a whole rather than to a specific field.","items":{"type":"string"}}},"additionalProperties":{"type":"array","description":"The list of error messages for the field named by the key.","items":{"type":"string"}}},"Error":{"type":"object","description":"An error response.","properties":{"detail":{"type":"string","description":"A human-readable description of the error."}},"additionalProperties":true}},"responses":{"ValidationError":{"description":"The request contains invalid or missing data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"Unauthorized":{"description":"Authentication credentials were not provided or are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The authenticated user does not have administrator privileges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InvalidPage":{"description":"The requested `page` does not exist — it is past the last page or not a valid page number. Paginated list endpoints answer with `404` rather than an empty page. The literal value `last` is accepted and returns the final page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/special_pages/detailed/":{"get":{"tags":["Special Pages"],"operationId":"listSpecialPagesDetailed","summary":"List special pages (detailed)","description":"Returns the same paginated list as `GET /special_pages/`, with the same filters and ordering, but each page carries its product collection as a nested object. The detailed representation does not include `pretty_url`.\n\nTranslatable fields are always returned in the default language; the language selected for the request is not applied.","parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/sort"},{"$ref":"#/components/parameters/specialPageNameFilter"},{"$ref":"#/components/parameters/specialPageUrlFilter"},{"$ref":"#/components/parameters/specialPageTemplateFilter"},{"$ref":"#/components/parameters/specialPageBannerUrlFilter"},{"$ref":"#/components/parameters/specialPageVideoEmbeddedCodeFilter"},{"$ref":"#/components/parameters/specialPageExtractionStrategyFilter"},{"$ref":"#/components/parameters/specialPageProductCollectionFilter"},{"$ref":"#/components/parameters/specialPageBannerDescriptionFilter"},{"$ref":"#/components/parameters/specialPageIsActiveFilter"},{"$ref":"#/components/parameters/specialPagePrettyUrlFilter"},{"$ref":"#/components/parameters/specialPageCreatedDateFilter"},{"$ref":"#/components/parameters/specialPageModifiedDateFilter"}],"responses":{"200":{"description":"A paginated list of special pages in the detailed representation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedSpecialPageDetailedList"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/InvalidPage"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://apidocs.akinon.com/commerce-openapis/admin/special-pages/list-special-pages-detailed.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
