Storyblok
Search Storyblok's Documentation
  1. Retrieve Multiple Datasource Entries

Management API

Retrieve Multiple Datasource Entries

Returns an array of datasource entry objects. This endpoint is paged and can be filtered by a datasource id or slug. The dimension parameter allows you to have the dimension value filled with the according data.

https://api.storyblok.com/v2/cdn/spaces/:space_id/datasource_entries/

It is necessary to add datasource_id or datasource_slug (at least one of them) in query parameters to get the results, dimension can be used with both.

The endpoint is not paginated if you use datasource_slug as a query param.

Path Parameters

  • :space_id

    required number

    Numeric ID of a space

Query Parameters

  • datasource_id

    number

    Provide the numeric id of a datasource

  • datasource_slug

    string

    Provide the slug of a datasource

  • dimension

    string

    Provide dimension id to receive the dimension_value filled

Response Properties

  • datasource_entries

    The Datasource Entry Object[]

    An array of datasource entry objects

    • id

      number

      The numeric ID

    • name

      string

      The key name of the datasource entry

    • value

      string

      Given value in the default dimension

    • dimension_value

      string

      Given value in the requested dimension

Example Request

Request
curl "https://mapi.storyblok.com/v1/spaces/233027/datasource_entries/?datasource_id=234&dimension=123" \
  -X GET \
  -H "Authorization: YOUR_OAUTH_TOKEN" \
  -H "Content-Type: application/json"
Request
// Using the Universal JavaScript Client:
// https://github.com/storyblok/storyblok-js-client
Storyblok.get('/spaces/233027/datasource_entries/', {
  "datasource_id": "234",
  "dimension": "123"
})
  .then(response => {
    console.log(response)
  }).catch(error => { 
    console.log(error)
  })
Request
$client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN');

$client->get('/spaces/233027/datasource_entries/', [
  "datasource_id" =>  "234",
  "dimension" =>  "123"
])->getBody();
Request
require 'storyblok'
client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN')

client.false('/spaces/233027/datasource_entries/', {:params => {
  "datasource_id" =>  "234",
  "dimension" =>  "123"
}})
Request
HttpResponse<String> response = Unirest.get("https://mapi.storyblok.com/v1/spaces/233027/datasource_entries/?datasource_id=234&dimension=123")
  .header("Authorization", "YOUR_OAUTH_TOKEN")
  .asString();
Request
var client = new RestClient("https://mapi.storyblok.com/v1/spaces/233027/datasource_entries/?datasource_id=234&dimension=123");
var request = new RestRequest(Method.GET);

request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN");
IRestResponse response = client.Execute(request);
Request
import Foundation

let headers = [
  "Content-Type": "application/json",
  "Authorization": "YOUR_OAUTH_TOKEN"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://mapi.storyblok.com/v1/spaces/233027/datasource_entries/?datasource_id=234&dimension=123")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0)
request.method = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Request
import requests

url = "https://mapi.storyblok.com/v1/spaces/233027/datasource_entries/"

querystring = {"datasource_id":"234","dimension":"123"}

payload = ""
headers = {
  'Content-Type': "application/json",
  'Authorization': "YOUR_OAUTH_TOKEN"
}

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

print(response.text)