Braintest
GET/v1/dataset

List datasets

List out all datasets. The datasets are sorted by creation date, with the most recently-created datasets coming first

8 parameters
limitintegeroptional

Limit the number of objects to return

starting_afterstringoptional

Pagination cursor id.

For example, if the final item in the last page you fetched had an id of foo, pass starting_after=foo to fetch the next page. Note: you may only pass one of starting_after and ending_before

ending_beforestringoptional

Pagination cursor id.

For example, if the initial item in the last page you fetched had an id of foo, pass ending_before=foo to fetch the previous page. Note: you may only pass one of starting_after and ending_before

idsstringoptional

Filter search results to a particular set of object IDs. To specify a list of IDs, include the query param multiple times

dataset_namestringoptional

Name of the dataset to search for

project_namestringoptional

Name of the project to search for

project_idstringoptional

Project id

org_namestringoptional

Filter search results to within a particular organization

6 status codes
200Returns a list of dataset objects
objectsarray<object>required

A list of dataset objects

400The request was unacceptable, often due to missing a required parameter
401No valid API key provided
403The API key doesn’t have permissions to perform the request
429Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
500Something went wrong on Braintrust's end. (These are rare.)

Error handling

A 400 is returned: The request was unacceptable, often due to missing a required parameter A 401 is returned: No valid API key provided A 403 is returned: The API key doesn’t have permissions to perform the request A 429 is returned: Too many requests hit the API too quickly. We recommend an exponential backoff of your requests A 500 is returned: Something went wrong on Braintrust's end. (These are rare.)