Retrieve a Single Story

Retrieve a single story by full slug, ID, or UUID. Includes parameters for resolving links and relations.

GET

https://api.storyblok.com/v2/cdn/stories/:id

Path parameters

:id required string
The story’s id, uuid, or full_slug. Examples: home (Full slug), 66252740648132 (Numeric ID), 73a1d66c-dedc-48da-8174-0f2ca6441293 (UUID).

Query parameters

find_by string
Required when using the story uuid as a path parameter.
version string
Filter by the story’s publication status.
resolve_links string
Resolve link fields. The links property of the response includes resolved links:
- link: provides access to additional information, such as a linked story’s full_slug, path, parent_id, is_folder, published, is_startpage, position, alternates, real_path, and more.
- url: provides the minimum amount of information. Use when you only need the path of a linked story.
- story: resolves and returns the complete story object of a linked story.
resolve_links_level integer
Resolve up to two levels of links.
resolve_relations string
Used to resolve referenced stories. Resolved stories appear in the rels property of the response.
A single request can resolve up to 50 stories. Afterward, all story UUID appear in the rel_uuids property of the response and need to resolve in subsequent API requests.
To resolve the stories selected in one field, provide the technical name of the immediate parent component of the field, followed by a . and the field name. To resolve the stories selected in multiple fields, provide a comma-separated string.
Example: resolve_relations=page.author,page.categories.
from_release string
Access a story version in a specific release by providing the release ID.
content_type string
Retrieve stories of a specific content type block. For example, content_type=page.
cv integer
Cached version Unix timestamp. Learn more in the Caching concept.
excluding_fields string
To exclude specific fields of a content type, provide the field names as a comma-separated string. For example, excluding_fields=body,meta_description.
Excluding the component field from the response, returns the content of the story in the default language instead of the requested language.
excluding_story_fields string
Exclude top-level story response fields with a comma-separated list. For example, excluding_story_fields=alternates,translated_slugs.
language string
Retrieve translated story version. Accepts any language code configured in the Storyblok space.
fallback_lang string
Define a custom fallback language to handle untranslated fields. Accepts any language code configured in the space. Provide language code with underscores. For example, es_co instead of es-co.
resolve_assets integer
Used to resolve asset metadata, including custom metadata. When resolve_assets=1, an array of assets associated with the stories appear in the assets property of the response.
resolve_level integer
Used to force resolve second-level relations when the first level reaches a limit of 100 relations.
While resolving relations, if the first level exceeds 100 relations, the API stops looking for the second level. To resolve second-level relations regardless of the first-level relations’ limit, use resolve_level=2.
token required string
A preview or public access token configured in a space.

Response properties

story Story
Show child properties
- name string
  Story name.
- created_at string
  Creation timestamp. Supports ISO 8601.
- updated_at string | null
  Latest update timestamp. Supports ISO 8601.
- published_at string | null
  Latest publication timestamp. Supports ISO 8601.
- alternates array<StoryAlternate>
  An array that contains objects that provide basic data of the stories defined as alternates of the current story.
  Show child properties
  id integer
  Story ID.
  name string
  Story name.
  slug string
  Story slug.
  published boolean | null
  Returns true if the story is currently published.
  full_slug string
  The story’s full slug, including parent folder and language paths.
  is_folder boolean
  Returns true if the item is a folder.
  parent_id integer
  ID of the parent folder.
- id integer
  Story ID.
- uuid string
  Story UUID.
- content object
  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.
  Show child properties
  _uid string
  component string
- slug string
  Story.
- full_slug string
  The story’s full slug, including parent folder and language paths.
- default_full_slug string | null
  Contains the complete slug of the default language (requires the Translatable Slugs app).
- sort_by_date string | null
  Date defined in the story’s entry configuration. Supports ISO 8601.
- position integer
  Numeric representation of the story’s position in the folder. Users can change this property in the Content tab.
- tag_list array<string>
  An array of tags.
- is_startpage boolean
  Returns true if the story is the folder root.
- parent_id integer
  Parent folder ID.
- meta_data object | null
  An object to store non-editable data that’s exclusively maintained with the Management API.
- group_id string
  Group ID (UUID string), shared between stories defined as alternates.
- first_published_at string | null
  First publication timestamp. Supports ISO 8601.
- release_id integer | null
  Current release ID (if requested via the from_release parameter).
- lang string
  The story’s language code.
- path string | null
  Real path defined in the story’s entry configuration. Learn more in the Visual Editor concept).
- translated_slugs array | null
  An array of translated slug objects (requires the Translatable Slugs app).
  Show child properties
  path string
  Translated slug.
  name string | null
  Translated name.
  lang string
  The story’s language code.
  published boolean | null
  Returns true if story variant is currently published.
- taxonomy_terms array<object>
  To retrieve taxonomy terms assigned to the story, use with_taxonomy_terms=1.
  Show child properties
  id string
  display_name string
  name string
  taxonomy_id string
cv integer
Cached version Unix timestamp.
rels array<Story>
An array of resolved stories.
Show child properties
- name string
  Story name.
- created_at string
  Creation timestamp. Supports ISO 8601.
- updated_at string | null
  Latest update timestamp. Supports ISO 8601.
- published_at string | null
  Latest publication timestamp. Supports ISO 8601.
- alternates array<StoryAlternate>
  An array that contains objects that provide basic data of the stories defined as alternates of the current story.
  Show child properties
  id integer
  Story ID.
  name string
  Story name.
  slug string
  Story slug.
  published boolean | null
  Returns true if the story is currently published.
  full_slug string
  The story’s full slug, including parent folder and language paths.
  is_folder boolean
  Returns true if the item is a folder.
  parent_id integer
  ID of the parent folder.
- id integer
  Story ID.
- uuid string
  Story UUID.
- content object
  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.
  Show child properties
  _uid string
  component string
- slug string
  Story.
- full_slug string
  The story’s full slug, including parent folder and language paths.
- default_full_slug string | null
  Contains the complete slug of the default language (requires the Translatable Slugs app).
- sort_by_date string | null
  Date defined in the story’s entry configuration. Supports ISO 8601.
- position integer
  Numeric representation of the story’s position in the folder. Users can change this property in the Content tab.
- tag_list array<string>
  An array of tags.
- is_startpage boolean
  Returns true if the story is the folder root.
- parent_id integer
  Parent folder ID.
- meta_data object | null
  An object to store non-editable data that’s exclusively maintained with the Management API.
- group_id string
  Group ID (UUID string), shared between stories defined as alternates.
- first_published_at string | null
  First publication timestamp. Supports ISO 8601.
- release_id integer | null
  Current release ID (if requested via the from_release parameter).
- lang string
  The story’s language code.
- path string | null
  Real path defined in the story’s entry configuration. Learn more in the Visual Editor concept).
- translated_slugs array | null
  An array of translated slug objects (requires the Translatable Slugs app).
  Show child properties
  path string
  Translated slug.
  name string | null
  Translated name.
  lang string
  The story’s language code.
  published boolean | null
  Returns true if story variant is currently published.
- taxonomy_terms array<object>
  To retrieve taxonomy terms assigned to the story, use with_taxonomy_terms=1.
  Show child properties
  id string
  display_name string
  name string
  taxonomy_id string
links array<LinkWithFullSlug>
An array of resolved links.
Show child properties
- id integer
  Story or folder id.
- uuid string
  Story or folder uuid.
- slug string
  Story or folder full slug.
- path string | null
  Real path defined in the story’s entry configuration. Learn more in the Visual Editor concept).
- real_path string | null
  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
  Story or folder name.
- published boolean
  Returns true if the story is currently published.
- parent_id integer
  Parent folder ID.
- is_folder boolean
  Returns true if the item is a folder.
- is_startpage boolean
  Returns true if the story is the folder’s root.
- position integer
  Numeric representation of the story’s position in the folder. Users can change this property in the Content tab.
- published_at string | null
  Latest publication timestamp. Supports ISO 8601.
- created_at string | null
  Creation timestamp. Supports ISO 8601.
- updated_at string | null
  Latest update timestamp. Supports ISO 8601.
- alternates array<Alternate>
  An array that contains objects correlating to the language versions defined using field-level translation.
  The alternates parameter is different from the story alternates defined in the Dimensions app when using folder-level translation.
  Show child properties
  path string
  Translated story slug (learn more about the Translatable Slugs app).
  name string
  Translated story name (learn more about the Translatable Slugs app).
  lang string
  The story’s language code.
  published boolean
  Returns true if story language version is currently published.
  translated_slug string
  Translated story slug (learn more about the Translatable Slugs app).
- full_slug string
  The story’s full slug, including parent folder and language paths.
rel_uuids array<string>
An array of all referenced stories’ UUIDs.
link_uuids array<string>
An array of all linked stories’ UUIDs.

Examples

curl "https://api.storyblok.com/v2/cdn/stories/:id\
?token=ask9soUkv02QqbZgmZdeDAtt"

// storyblok-js-client@>=7, node@>=18
import Storyblok from "storyblok-js-client";

const storyblok = new Storyblok({
  accessToken: "krcV6QGxWORpYLUWt12xKQtt",
});

try {
  const response = await storyblok.get('cdn/stories/:id', {})
  console.log({ response })
} catch (error) {
  console.log(error)
}

$client = new \Storyblok\Client('YOUR_STORYBLOK_SPACE_ACCESS_TOKEN');

$client->getStoryBySlug(':id')->getBody();

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/stories/:id?token=ask9soUkv02QqbZgmZdeDAtt")
  .asString();

var client = new RestClient("https://api.storyblok.com/v2/cdn/stories/:id?token=ask9soUkv02QqbZgmZdeDAtt");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

import requests

url = "https://api.storyblok.com/v2/cdn/stories/:id"

querystring = {"token":"ask9soUkv02QqbZgmZdeDAtt"}

payload = ""
headers = {}

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)

require 'storyblok'
client = Storyblok::Client.new(token: 'YOUR_TOKEN')

client.story(':id')

let storyblok = URLSession(storyblok: .cdn(accessToken: "ask9soUkv02QqbZgmZdeDAtt"))
let request = URLRequest(storyblok: storyblok, path: "stories/:id")
let (data, _) = try await storyblok.data(for: request)
print(try JSONSerialization.jsonObject(with: data))

val client = HttpClient {
    install(Storyblok(CDN)) {
        accessToken = "ask9soUkv02QqbZgmZdeDAtt"
    }
}

val response = client.get("stories/:id")

println(response.body<JsonElement>())

{
"story": {
  "name": "Homepage",
  "created_at": "2025-01-15T09:30:00.000Z",
  "updated_at": "2025-06-02T14:12:05.000Z",
  "published_at": "2025-01-15T09:32:10.000Z",
  "id": 371891025,
  "uuid": "8f14e45f-ceea-467e-adc1-5c1b1a3a7b3b",
  "content": {
    "_uid": "b1f8c9a2-3d44-4c2e-9a1e-6e7d2f5c9a10",
    "component": "page",
    "body": [
      {
        "_uid": "1a2b3c4d-5e6f-4a1b-8c2d-9e0f1a2b3c4d",
        "component": "teaser",
        "headline": "Welcome to Storyblok"
      }
    ]
  },
  "slug": "home",
  "full_slug": "home",
  "sort_by_date": null,
  "position": 0,
  "tag_list": [
    "marketing",
    "featured"
  ],
  "is_startpage": true,
  "parent_id": 0,
  "meta_data": null,
  "group_id": "57350688-5a28-49d1-b5a9-086ae0d4c0d2",
  "first_published_at": "2025-01-15T09:32:10.000Z",
  "release_id": null,
  "lang": "default",
  "path": null,
  "alternates": [],
  "default_full_slug": null,
  "translated_slugs": null
},
"cv": 1717516800
}

Was this page helpful?

This site uses reCAPTCHA and Google's Privacy Policy (opens in a new window).Terms of Service (opens in a new window) apply.

Get in touch with the Storyblok community

Cookie notice

Retrieve a Single Story

Path parameters

Query parameters

Response properties

Examples