--- title: Retrieving Stories in a Particular Language description: Example demonstrating how to retrieve translated story versions using the language parameter in Storyblok's Content Delivery API. url: https://storyblok.com/docs/api/content-delivery/v2/stories/examples/retrieving-stories-in-a-particular-language --- # Retrieving Stories in a Particular Language Using the `language` parameter, it is possible to request translated versions of a single or multiple stories. Any language and its correlating i18n code defined in the Storyblok space is a possible value. - `language=es-co`: Returns the Spanish (Colombian) version(s) of a single or multiple stories. - `language=de`: Returns the German version(s) of a single or multiple stories. ## Example Request and Response The following example demonstrates how to receive the German version of a single story. - cURL ```shellscript curl "https://api.storyblok.com/v2/cdn/stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis\ ?language=de\ &token=krcV6QGxWORpYLUWt12xKQtt\ &version=published" ``` - JS ```javascript // 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/articles/earths-symphony-navigating-wonders-challenges-blue-oasis', { "language": "de", "version": "published" }) console.log({ response }) } catch (error) { console.log(error) } ``` - PHP ```php $client = new \Storyblok\Client('YOUR_STORYBLOK_SPACE_ACCESS_TOKEN'); $client->getStoryBySlug('articles/earths-symphony-navigating-wonders-challenges-blue-oasis', [ "language" => "de", "version" => "published" ])->getBody(); ``` - Java ```java HttpResponse response = Unirest.get("https://api.storyblok.com/v2/cdn/stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis?language=de&token=krcV6QGxWORpYLUWt12xKQtt&version=published") .asString(); ``` - C# ```csharp var client = new RestClient("https://api.storyblok.com/v2/cdn/stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis?language=de&token=krcV6QGxWORpYLUWt12xKQtt&version=published"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` - Python ```python import requests url = "https://api.storyblok.com/v2/cdn/stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis" querystring = {"language":"de","token":"krcV6QGxWORpYLUWt12xKQtt","version":"published"} payload = "" headers = {} response = requests.request("GET", url, data=payload, headers=headers, params=querystring) print(response.text) ``` - Ruby ```ruby require 'storyblok' client = Storyblok::Client.new(token: 'YOUR_TOKEN') client.story('articles/earths-symphony-navigating-wonders-challenges-blue-oasis', {:params => { "language" => "de", "version" => "published" }}) ``` - Swift ```swift let storyblok = URLSession(storyblok: .cdn(accessToken: "krcV6QGxWORpYLUWt12xKQtt")) var request = URLRequest(storyblok: storyblok, path: "stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis") request.url!.append(queryItems: [ URLQueryItem(name: "language", value: "de"), URLQueryItem(name: "version", value: "published") ]) let (data, _) = try await storyblok.data(for: request) print(try JSONSerialization.jsonObject(with: data)) ``` - Kotlin ```kotlin val client = HttpClient { install(Storyblok(CDN)) { accessToken = "krcV6QGxWORpYLUWt12xKQtt" } } val response = client.get("stories/articles/earths-symphony-navigating-wonders-challenges-blue-oasis") { url { parameters.append("language", "de") parameters.append("version", "published") } } println(response.body()) ``` Response ```json { "story": { "name": "Earth's Symphony: Navigating the Wonders and Challenges of Our Blue Oasis", "created_at": "2024-02-16T14:22:09.108Z", "published_at": "2024-03-21T16:48:09.206Z", "id": 444996765, "uuid": "660452d2-1a68-4493-b5b6-2f03b6fa722b", "content": { "_uid": "6bdf037c-f713-415c-a26a-8a9cfc926c85", "image": { "id": 14114772, "alt": "", "name": "", "focus": "", "title": "", "source": "", "filename": "https://a.storyblok.com/f/276232/2560x1946/ee938cf736/earth.jpg", "copyright": "", "fieldtype": "asset", "meta_data": {}, "is_private": "", "is_external_url": false }, "author": "51eed33d-855f-415c-ac0d-4404e03b89e1", "topics": ["solar-system"], "content": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.", "headline": "Die Symphonie der Erde: Die Wunder und Herausforderungen unserer blauen Oase", "component": "article", "scheduled": "2023-10-01 15:00", "categories": ["45d968b6-5790-4fbb-aa41-5781b8edde51", "d8e48716-0ecf-4059-b568-343bf54e4128"], "highlighted": false }, "slug": "earths-symphony-navigating-wonders-challenges-blue-oasis", "full_slug": "de/articles/earths-symphony-navigating-wonders-challenges-blue-oasis", "sort_by_date": null, "position": 0, "tag_list": ["Editor's Choice", "Featured"], "is_startpage": false, "parent_id": 444991588, "meta_data": null, "group_id": "8d99d18d-5c97-42cd-a646-51e0c553f26a", "first_published_at": "2024-02-16T14:30:11.990Z", "release_id": null, "lang": "de", "path": null, "alternates": [], "default_full_slug": null, "translated_slugs": null }, "cv": 1711108220, "rels": [], "links": [] } ``` ## Pagination - [Previous: Retrieving Stories from a Folder](/docs/api/content-delivery/v2/stories/examples/retrieving-stories-from-a-folder) - [Next: Retrieving Stories with Resolved Relations](/docs/api/content-delivery/v2/stories/examples/retrieving-stories-with-resolved-relations)