Skip to main content
GET
/
v1
/
datasets
List DataSets
curl --request GET \
  --url https://api.domo.com/v1/datasets \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "08a061e2-12a2-4646-b4bc-20beddb403e3",
    "name": "Questions regarding Euclid's Fundamental Theorem of Arithmetic",
    "rows": 1,
    "columns": 6,
    "createdAt": "2015-12-10T07:06:14Z",
    "updatedAt": "2016-02-29T20:56:20.567Z"
  },
  {
    "id": "317970a1-6a6e-4f70-8e09-44cf5f34cf44",
    "name": "Ideas Regarding Physics",
    "description": "Notes",
    "rows": 1289280,
    "columns": 9,
    "createdAt": "2013-09-24T20:51:48Z",
    "updatedAt": "2016-02-29T20:56:07.619Z"
  },
  {
    "id": "cc22901d-c856-47c5-89a3-5228a4fa5663",
    "name": "Rene Descartes Mentions",
    "description": "",
    "rows": 194723231,
    "columns": 12,
    "createdAt": "2014-05-01T22:01:17Z",
    "updatedAt": "2016-02-29T20:56:05.034Z"
  },
  {
    "id": "36ea3481-5b90-4181-a4a8-4d9388e85d9e",
    "name": "Symbolic Logic",
    "description": "",
    "rows": 349660,
    "columns": 12,
    "createdAt": "2014-11-26T18:29:09Z",
    "updatedAt": "2016-02-29T20:55:50.337Z"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer

The amount of DataSets to return in the list. The default is 50 and the maximum is 50.

​
offset
integer

The offset of the DataSet ID to begin list of users within the response.

​
sort
enum<string>

The order to return the DataSets in.

Available options:
name,
nameDescending,
lastTouched,
lastTouchedAscending,
lastUpdated,
lastUpdatedAscending,
createdAt,
createdAtAscending,
cardCount,
cardCountAscending,
cardViewCount,
cardViewCountAscending,
errorState,
errorStateDescending,
dataSourceId
​
nameLike
string

If included, will limit the list of DataSets to those with names that contain the string passed in. nameLike is case insensitive.

Response

200 - application/json

Returns all DataSet objects that meet argument criteria from original request.

​
id
string
​
name
string
​
rows
integer
​
columns
integer
​
createdAt
string
​
updatedAt
string
​
description
string