Listing Dataset Versions

This endpoint lists the data versions that are available for a dataset. Each dataversion records includes metadata indicating the following:

uploadStatus - success, error, processing numRows - the number of rows in the upload numBytes - the size of the upload in bytes schemaId - the schema associated with the data recordedDate - the time at which the data was made available to the system uploadCompletedDate - the time the upload finished uploading

GET /api/data/v2/datasources/{datasetId}/dataversions

Listing Dataset Versions

cURL

curl --request GET \
  --url https://{instance}.domo.com/api/data/v2/datasources/{datasetId}/dataversions \
  --header 'X-DOMO-Developer-Token: <api-key>'

200

[
  {
    "schemaId": 5,
    "dataId": 3,
    "uploadStatus": "success",
    "recordedDate": "2023-03-31T14:21:13Z",
    "uploadCompletedDate": "2023-03-31T14:21:13Z",
    "numRows": 18,
    "numBytes": 458
  },
  {
    "schemaId": 7,
    "dataId": 4,
    "uploadStatus": "success",
    "recordedDate": "2023-03-31T14:21:28Z",
    "uploadCompletedDate": "2023-03-31T14:21:28Z",
    "numRows": 499,
    "numBytes": 6890
  }
]

Authorizations

X-DOMO-Developer-Token · string · header · required

Path Parameters

datasetId · string · required

Response

200 - application/json

Response

schemaId · integer

dataId · integer

uploadStatus · enum<string>

Available options: success, error, processing

recordedDate · string<date-time>

uploadCompletedDate · string<date-time>

numRows · integer

numBytes · integer