Get Datasets Service

URL	`http://baoapi.esri.com/rest/report/GetDatasets`

Query the names of the publicly-available datasets currently hosted by the Online API.

Output

The Get Datasets service returns a list of dataset IDs currently available on the Online API.

Description

The Online API now contains updated content and support for additional datasets. In addition to existing U.S-specific data and content covering previous years, all of the existing API services can now be used to access and leverage additional datasets including a new U.S. Census 2010 dataset and a new Canadian dataset.

Usage Tips

After generating the list of available dataset IDs, choose of the ID values and specify it as the value of the ActiveDatasetID parameter in a Web services request.
The ActiveDatasetID parameter is available in most tasks and is optional.
The dataset with the ID of 'USA' is the default datatset of the Online API. If you only plan to leverage the 'USA' dataset, you do not need to specify it as the value of the ActiveDatasetID parameter in the Web service request.
Access to the various datasets, including summarization/analysis variables, standard geography/administrative boundary data layers and features, and other data and content are subject to availability and the terms/restrictions associated with your API subscription.

You can provide arguments to the Get Summarizations utility service as defined in the parameters table below.

Parameters

Parameter Details

Parameter	Details
Token (Required)	Description: A valid API token string. Syntax: `Token=<string>` Example: `Token=ABC123...` Notes: The value associated with the Token parameter is for example purposes only. See Get Token for more information on obtaining a token.
Callback	Description: Wrap the JSON or PJSON response in a named function that can be executed by client-side JavaScript upon receipt. Default: `null` Syntax: `Callback=<string>` Example: `Callback=MyCallbackFunction` Notes: The response will be wrapped in a callback function only if a non-null Callback parameter value is specified and if the response format (the `f` parameter) is set to JSON or PJSON. Callback functions are useful for consuming the service in JavaScript-based client applications as shown in this basic example.
f	Description: The response format. Default: HTML Syntax: `f=<HTML \| JSON \| PJSON>` Example: `f=JSON`

Token (Required)

Description: A valid API token string.

Syntax: Token=<string>

Example: Token=ABC123...

Notes: The value associated with the Token parameter is for example purposes only. See Get Token for more information on obtaining a token.

Callback

Description: Wrap the JSON or PJSON response in a named function that can be executed by client-side JavaScript upon receipt.

Default: null
Syntax: Callback=<string>

Example: Callback=MyCallbackFunction

Notes:
The response will be wrapped in a callback function only if a non-null Callback parameter value is specified and if the response format (the f parameter) is set to JSON or PJSON.

Callback functions are useful for consuming the service in JavaScript-based client applications as shown in this basic example.

Description: The response format.

Default: HTML

Syntax: f=<HTML | JSON | PJSON>

Example: f=JSON

Example Usage

Example 1: Get a list of datasets available on the Online API.

Request Example (1)

http://baoapi.esri.com/rest/report/GetDatasets?
f=PJSON&
Token=ABC123

Access to the various datasets, including summarization/analysis variables, standard geography/administrative boundary data layers and features, and other data and content are subject to availability and the terms/restrictions associated with your API subscription.

Example Response

JSON Response Syntax

{
  "Result": <ArrayOfString2>
}

JSON Response Example