Braintest
GET/v1/experiment

List experiments

List out all experiments. The experiments are sorted by creation date, with the most recently-created experiments 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
experiment_namestringoptional
Name of the experiment 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 experiment objects
objectsarray<object>required
A list of experiment 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.)