--- title: "Retrieve Multiple Stories" method: GET path: "/v2/cdn/stories" tags: ["Stories"] --- # Retrieve Multiple Stories `GET /v2/cdn/stories` ## Request - Base URL: `https://api.storyblok.com` - URL: `https://api.storyblok.com/v2/cdn/stories` - Auth: API key in query parameter `token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve multiple stories from Storyblok with filtering, pagination, sorting, and relation resolution options. ## Query parameters - `version` 'draft' | 'published' - `cv` integer - `starts_with` string - `search_term` string - `sort_by` string - `per_page` integer - `page` integer - `by_slugs` string - `excluding_slugs` string - `published_at_gt` string, date-time - `published_at_gte` string, date-time - `published_at_lt` string - `published_at_lte` string, date-time - `first_published_at_gt` string, date-time - `first_published_at_gte` string, date-time - `first_published_at_lt` string - `first_published_at_lte` string, date-time - `updated_at_gt` string, date-time - `updated_at_gte` string, date-time - `updated_at_lt` string - `updated_at_lte` string, date-time - `in_workflow_stages` string - `content_type` string - `level` integer - `resolve_relations` string - `excluding_ids` string - `by_uuids` string - `by_uuids_ordered` string - `by_ids` string - `with_tag` string - `is_startpage` 0 | 1 - `resolve_links` 'story' | 'url' | 'link' - `resolve_links_level` 1 | 2 - `resolve_links_in_relations` 1 - `from_release` string - `fallback_lang` string - `language` string - `filter_query` object - `__or` object[] - `excluding_fields` string - `including_fields` string - `excluding_story_fields` string - `resolve_assets` 1 - `resolve_level` 2 - `only_variants` 'true' - `token` string, required ## Response `200` Stories listed - object - `stories` Story[], required: An array of story objects. - union - DraftStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (UUID string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable, required: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - PublishedStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (`uuid` string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - `cv` integer, required: Cached version Unix timestamp. Learn more in the [Caching concept](https://www.storyblok.com/docs/concepts/caching). - `rels` Story[]: An array of resolved stories. - union - DraftStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (UUID string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable, required: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - PublishedStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (`uuid` string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - `links` union[]: An array of resolved links. The properties depend on the `resolve_links` value. - union - LinkWithFullSlug - `id` integer, required: Story or folder ID. - `uuid` string, uuid, required: Story or folder UUID. - `slug` string, required: Story or folder `full_slug`. - `path` string, nullable: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `real_path` string, nullable: Either the full slug of the story or folder with a leading `/`, or the value of the real path defined in the story’s entry configuration with a leading `/`. - `name` string, required: Story or folder name. - `published` boolean, required: Returns `true` if the story is currently published. - `parent_id` integer, required: Parent folder ID. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `is_startpage` boolean, required: Returns `true` if the story is the folder’s root. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `published_at` string, date-time, nullable: Latest publication timestamp. Supports ISO 8601. - `created_at` string, date-time, nullable: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `alternates` Alternate[]: An array that contains objects correlating to the language versions defined using [field-level translation](https://www.storyblok.com/docs/concepts/internationalization#field-level-translation). The `alternates` parameter is different from the story alternates defined in the [Dimensions app](https://www.storyblok.com/docs/apps/dimensions) when using [folder-level translation](https://www.storyblok.com/docs/concepts/internationalization#folder-level-translation). - `path` string, required: Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `name` string, required: Translated story name (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `lang` string, required: The story’s language code. - `published` boolean, required: Returns `true` if story language version is currently published. - `translated_slug` string, required: Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - ResolvedLinkUrl: Linked story or folder in the `links` array when `resolve_links` is `url`. - `id` integer, required: Story or folder ID. - `uuid` string, uuid, required: Story or folder UUID. - `name` string, required: Story or folder name. - `slug` string, required: Story or folder slug. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `url` string, required: The `real_path` defined in the story or folder’s Config, or the `full_slug`. - Link - `id` integer, required: Story or folder ID. - `uuid` string, uuid, required: Story or folder UUID. - `slug` string, required: Story or folder `full_slug`. - `path` string, nullable: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `real_path` string, nullable: Either the full slug of the story or folder with a leading `/`, or the value of the real path defined in the story’s entry configuration with a leading `/`. - `name` string, required: Story or folder name. - `published` boolean, required: Returns `true` if the story is currently published. - `parent_id` integer, required: Parent folder ID. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `is_startpage` boolean, required: Returns `true` if the story is the folder’s root. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `published_at` string, date-time, nullable: Latest publication timestamp. Supports ISO 8601. - `created_at` string, date-time, nullable: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `alternates` Alternate[]: An array that contains objects correlating to the language versions defined using [field-level translation](https://www.storyblok.com/docs/concepts/internationalization#field-level-translation). The `alternates` parameter is different from the story alternates defined in the [Dimensions app](https://www.storyblok.com/docs/apps/dimensions) when using [folder-level translation](https://www.storyblok.com/docs/concepts/internationalization#folder-level-translation). - `path` string, required: Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `name` string, required: Translated story name (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `lang` string, required: The story’s language code. - `published` boolean, required: Returns `true` if story language version is currently published. - `translated_slug` string, required: Translated story slug (learn more about the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - union - DraftStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (UUID string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable, required: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - PublishedStory - `name` string, required: Story name. - `created_at` string, date-time, required: Creation timestamp. Supports ISO 8601. - `updated_at` string, date-time, nullable: Latest update timestamp. Supports ISO 8601. - `published_at` string, date-time, nullable, required: Latest publication timestamp. Supports ISO 8601. - `id` integer, required: Story ID. - `uuid` string, uuid, required: Story UUID. - `content` object, required: An object that contains the field data associated with a content type’s specific structure. Also includes a `component` property with the content type’s technical name. - `_uid` string - `component` string - `slug` string, required: Story. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `sort_by_date` string, nullable, required: Date defined in the story’s entry configuration. Supports ISO 8601. - `position` integer, required: Numeric representation of the story’s position in the folder. Users [can change](https://www.storyblok.com/docs/manuals/stories#folders) this property in the **Content** tab. - `tag_list` string[], required: An array of tags. - `is_startpage` boolean, required: Returns `true` if the story is the folder root. - `parent_id` integer, required: Parent folder ID. - `meta_data` object, nullable, required: An object to store non-editable data that’s exclusively maintained with the [Management API](https://www.storyblok.com/docs/api/management). - `group_id` string, required: Group ID (`uuid` string), shared between stories defined as alternates. - `first_published_at` string, date-time, nullable, required: First publication timestamp. Supports ISO 8601. - `release_id` integer, nullable: Current release ID (if requested via the `from_release` parameter). - `lang` string, required: The story’s language code. - `path` string, nullable, required: Real path defined in the story’s entry configuration. Learn more in the [Visual Editor concept](https://www.storyblok.com/docs/concepts/visual-editor)). - `alternates` StoryAlternate[], required: An array that contains objects that provide basic data of the stories defined as alternates of the current story. - `id` integer, required: Story ID. - `name` string, required: Story name. - `slug` string, required: Story slug. - `published` boolean, nullable, required: Returns `true` if the story is currently published. - `full_slug` string, required: The story’s full slug, including parent folder and language paths. - `is_folder` boolean, required: Returns `true` if the item is a folder. - `parent_id` integer, required: Parent folder ID. - `default_full_slug` string, nullable, required: Contains the complete slug of the default language (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `translated_slugs` object[], nullable, required: An array of translated slug objects (requires the [Translatable Slugs app](https://www.storyblok.com/docs/apps/translatable-slugs)). - `path` string, required: Translated slug. - `name` string, nullable, required: Translated name. - `lang` string, required: The story’s language code. - `published` boolean, nullable, required: Returns `true` if story variant is currently published. - `taxonomy_terms` object[]: To retrieve taxonomy terms assigned to the story, use `with_taxonomy_terms=1`. - `id` string, required - `display_name` string, required - `name` string, required - `taxonomy_id` string, required - `rel_uuids` string[]: An array of all referenced stories’ UUIDs. - `link_uuids` string[]: An array of all linked stories’ UUIDs. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `422`: Invalid query parameters - `429`: Rate limit reached ## Changes - **2026-11-11** `6981ed842964`: 2 info - added the new optional `query` request parameter `including_fields` - added the new optional `query` request parameter `resolve_links_in_relations` [Operation history](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/changes/v2/cdn/stories/get.md) --- [API](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api.md) - [All operations](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/storyblok/apis/storyblok-content-delivery-api/revisions/6981ed842964?raw)