Retrieving Localized Stories by UUID

Utilizing the query parameter language in conjunction with find_by=uuid facilitates the retrieval of localized versions of entries without requiring knowledge of their slugs.

Example Request and Response

The following example demonstrates how to receive the German version of a single story without knowing its slug.

cURL

curl "https://api.storyblok.com/v2/cdn/stories/bfea4895-8a19-4e82-ae1c-1c591dce3094\
?find_by=uuid\
&language=de-DE\
&token=ask9soUkv02QqbZgmZdeDAtt\
&version=published"

JS

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

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

try {
  const response = await storyblok.get('cdn/stories/bfea4895-8a19-4e82-ae1c-1c591dce3094', {
    "find_by": "uuid",
    "language": "de-DE",
    "version": "published"
  })
  console.log({ response })
} catch (error) {
  console.log(error)
}

PHP

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

$client->getStoryByUuid('bfea4895-8a19-4e82-ae1c-1c591dce3094', [
  "find_by" => "uuid",
  "language" => "de-DE",
  "version" => "published"
])->getBody();

Java

HttpResponse<String> response = Unirest.get("https://api.storyblok.com/v2/cdn/stories/bfea4895-8a19-4e82-ae1c-1c591dce3094?find_by=uuid&language=de-DE&token=ask9soUkv02QqbZgmZdeDAtt&version=published")
  .asString();

C#

var client = new RestClient("https://api.storyblok.com/v2/cdn/stories/bfea4895-8a19-4e82-ae1c-1c591dce3094?find_by=uuid&language=de-DE&token=ask9soUkv02QqbZgmZdeDAtt&version=published");
var request = new RestRequest(Method.GET);

IRestResponse response = client.Execute(request);

Python

import requests

url = "https://api.storyblok.com/v2/cdn/stories/bfea4895-8a19-4e82-ae1c-1c591dce3094"

querystring = {"find_by":"uuid","language":"de-DE","token":"ask9soUkv02QqbZgmZdeDAtt","version":"published"}

payload = ""
headers = {}

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

print(response.text)

Ruby

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

client.story('bfea4895-8a19-4e82-ae1c-1c591dce3094', {:params => {
  "find_by" => "uuid",
  "language" => "de-DE",
  "version" => "published"
}})

Swift

// .package(url: "https://github.com/storyblok/storyblok-swift.git", from: "1.1.0")
// Requires a `Block` content model — see https://www.storyblok.com/docs/quickstarts/apple-platforms/content-modeling
let client = StoryblokClient(
    library: Block.self,
    accessToken: "ask9soUkv02QqbZgmZdeDAtt",
    version: .published,
    region: .eu,
    language: "de-DE"
)

let story: Story<Block>? = try await client
    .story(UUID(uuidString: "bfea4895-8a19-4e82-ae1c-1c591dce3094")!)
    .last()
    .values
    .first { @Sendable _ in true }

print(story!)

Kotlin

// implementation("com.storyblok:content-api-client:0.7.1")
val client = StoryblokClient(
    accessToken = "ask9soUkv02QqbZgmZdeDAtt",
    version = Published,
    language = "de-DE",
)

val story = client
    .story(Uuid.parse("bfea4895-8a19-4e82-ae1c-1c591dce3094"))
    .last()

println(story)

Response

{
  "story": {
    "name": "My first Post",
    "created_at": "2018-04-24T11:57:29.321Z",
    "published_at": "2026-10-13T08:59:51.908Z",
    "updated_at": "2026-10-13T08:59:51.886Z",
    "id": 107351,
    "uuid": "bfea4895-8a19-4e82-ae1c-1c591dce3094",
    "content": {
      "_uid": "2caef8f8-9c37-46b4-af19-8744ec5e1053",
      "image": "//a.storyblok.com/f/44162/1500x500/68b522b06d/1500x500.jpeg",
      "title": "Dies ist der erste Titel meines Beitrags",
      "author": "c47be9f0-47c3-4315-a95a-550f0c560eb5",
      "topics": "Finance",
      "content": "Lorem ipsum dolor sit amet, *consectetur* adipisicing elit, sed do eiusmod\ntempor incididunt ut **labore et dolore magna aliqua**. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. ***Duis aute irure dolor*** in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. ~~Excepteur sint occaecat~~ cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\n## H2\n\nLorem ipsum dolor sit amet, *consectetur* adipisicing elit, sed do eiusmod\ntempor incididunt ut **labore et dolore magna aliqua**. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. \n\n---\n\n***Duis aute irure dolor*** in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. ~~Excepteur sint occaecat~~ cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\n### H3\n\nunordered list:\n\n* item-1\n  * sub-item-1\n  * sub-item-2\n- item-2\n  - sub-item-3\n  - sub-item-4\n+ item-3\n  + sub-item-5\n  + sub-item-6\n\n\nordered list:\n\n1. item-1\n   1. sub-item-1\n   2. sub-item-2\n2. item-2\n   1. sub-item-3\n   2. sub-item-4\n3. item-3\n\n#### Header4\n\nTable Header-1 | Table Header-2 | Table Header-3\n:--- | :---: | ---:\nTable Data-1 | Table Data-2 | Table Data-3\nTD-4 | Td-5 | TD-6\nTable Data-7 | Table Data-8 | Table Data-9\n\n##### Header5\n\nYou may also want some images right in here like ![GitHub Logo](https://cloud.githubusercontent.com/assets/5456665/13322882/e74f6626-dc00-11e5-921d-f6d024a01eaa.png \"GitHub\") - you can do that but I would recommend you to use the component \"image\" and simply split your text.\n\n###### Header6\n\nLet us do some links -\n this for example: https://github.com/MinhasKamal/github-markdown-syntax is **NOT** a link but this:\n is [GitHub](https://github.com/MinhasKamal/github-markdown-syntax)",
      "schedule": "2026-10-12 09:00",
      "component": "post",
      "categories": [
        "9aa72a2f-04ae-48df-b71f-25f53044dc97",
        "84550816-245d-4fe6-8ae8-b633d4a328f4"
      ],
      "description": "Beschreibung des ersten",
      "highlighted": true
    },
    "slug": "my-first-post",
    "full_slug": "de-DE/posts/my-first-post",
    "sort_by_date": null,
    "position": 0,
    "tag_list": [],
    "is_startpage": false,
    "parent_id": 107348,
    "meta_data": null,
    "group_id": "6900d2ec-034a-420a-a1c5-9dca2039a81d",
    "first_published_at": "2026-10-13T08:59:51.908Z",
    "release_id": null,
    "lang": "de-DE",
    "path": null,
    "alternates": [],
    "default_full_slug": null,
    "translated_slugs": null
  },
  "cv": 1792059567,
  "rels": [],
  "links": []
}