Version 1 - Time Series Details

Released At: 29 Apr 2015Last Updated At: 02 Nov 2015

Get details about a time series.

URL

To call this method, use an HTTP GET request to the following URL:

http://data.unicef.ge/[locale]/api/v1/time_series

where:

  • [locale] = the locale of the language you want the data to be returned in (currently ka for Georgian or en for English)

Required Parameters

The following parameters must be included in the request:

ParameterDescription
access_token All requests must include an access_token. You can obtain an access token easily, and for free, by going here.
time_series_id The ID of the time series.

Optional Parameters

There following parameters are optional for this call.

ParameterDescription
language Code of the language to return the time series information in (e.g., en for English). If language is not provided, the default language of the time series will be used.

What You Get

The return object is a JSON object of time series information with the following information:

ParameterDescription
id Unique ID of the time series
title The title of the time series
dates_included An array of the dates that are included in the time series.The dates may represent a year, month/year, etc - there is no specific format for these values.
description A description of the time series, may include htmlmarkup
public_at Date the data was made public on this site, format: yyyy-mm-dd (e.g., 2015-01-31)
languages An array of the languages that are available in this dateset
default_language Thelanguage that is used by default

Examples

Here is an example of what can be returned after calling this method with the following url:

http://data.unicef.ge/en/api/v1/time_series?access_token=123456789&time_series_id=1111111111
{
  {
    id: "1111111111",
    title: "This is a time series!",
    dates_included: [
      "2009",
      "2011",
      "2013"
    ],
    description: "This is an amazing time series!"
    public_at: "2015-03-01"
    languages:[
      "en",
      "ka"
    ],
    default_language: "en"
  }
}