Skip to main content
GET
/
api
/
v1
/
datasets
List datasets
curl --request GET \
  --url https://api.mathfi.ai/api/v1/datasets \
  --header 'Authorization: Bearer <token>'
{
  "datasets": [
    {
      "datasetKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "datasetName": "<string>",
      "status": "PENDING",
      "numberOfBuckets": 123,
      "modelKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdOn": "2023-11-07T05:31:56Z"
    }
  ],
  "offset": 123,
  "limit": 123,
  "total": 123,
  "nextOffset": 123
}

Authorizations

​
Authorization
string
header
required

Obtain a token from POST /api/login. Valid for 1 hour.

Query Parameters

​
offset
integer<int64>
required

Number of items to skip

Required range: x >= 0
Example:

0

​
limit
integer<int64>
required

Maximum number of items to return

Required range: x >= 1
Example:

10

​
state
enum<string>

Filter by dataset status Processing status of a dataset:

StatusDescription
PENDINGCreated, awaiting data upload
PROCESSINGData uploaded, preparation in progress
COMPLETEDReady for training
FAILEDProcessing failed
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
​
withModelOnly
boolean

When true, only returns datasets that have a trained model

Response

Datasets listed successfully

​
datasets
object[]
required
​
offset
integer<int64>
required
​
limit
integer<int64>
required
​
total
integer<int64>
required
​
nextOffset
integer<int64>