List Experiments

GET/v2/project/{project_key}/experiments

Return all experiments for the company tied to the provided project key. Supports pagination.

Query parameters

Parameter	Type	Default	Description
`limit`	integer	`50`	Max results to return. Maximum `500`.
`offset`	integer	`0`	Number of records to skip (for pagination).

Example

curl "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/experiments?limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_GENERATED_API_KEY"

Success response

{
  "success": true,
  "company_id": 1001,
  "count": 2,
  "experiments": [
    {
      "test_id": 1234,
      "test_name": "Homepage CTA Button Color Test",
      "url": "https://example.com/",
      "status": 1,
      "is_completed": 0,
      "hypothesis_id": 4021,
      "hypothesis": {
        "hypothesis_id": 4021,
        "problem": "The plan comparison is three screens tall on a phone.",
        "solution": "Collapse the comparison into a single card with a plan switcher."
      },
      "created_at": "2024-01-15T10:30:00.000Z",
      "updated_at": "2024-01-20T14:22:00.000Z"
    },
    {
      "test_id": 1235,
      "test_name": "Pricing Page Hero Copy Test",
      "url": "https://example.com/pricing",
      "status": 0,
      "is_completed": 1,
      "hypothesis_id": null,
      "created_at": "2024-02-01T08:00:00.000Z",
      "updated_at": "2024-03-01T09:00:00.000Z"
    }
  ]
}

Response fields

Field	Type	Description
`experiments`	array	List of experiment objects
`experiments[].test_id`	integer	Unique experiment ID — use this in all other experiment endpoints
`experiments[].test_name`	string	Display name
`experiments[].url`	string	The page URL being tested
`experiments[].status`	integer	Numeric status (see table below)
`experiments[].is_completed`	integer	`1` if the experiment was formally concluded via the dashboard, `0` otherwise. Deactivating via API (`status: 0`) does not set this — it is only set from the Mida dashboard.
`experiments[].hypothesis_id`	integer\|null	The hypothesis this test came from, if any. Pass it to Get Hypothesis Details
`experiments[].hypothesis`	object	Only present when the experiment has one: `hypothesis_id`, `observation`, `problem` and `solution`, so a list of tests reads as a list of reasons. Fields left blank are omitted. Ratings live on Get Hypothesis Details
`experiments[].created_at`	string	ISO 8601 creation timestamp
`experiments[].updated_at`	string	ISO 8601 last-updated timestamp
`experiments[].serving_variant_id`	string \| null	Present when the experiment is serving a winner at 100% on the same test
`experiments[].is_deploy`	integer	Legacy deploy flag; prefer `serving_variant_id` for unified serving
`count`	integer	Total number of experiments returned

Status values

Value	Meaning
`9`	Draft — created but not yet started
`1`	Live — actively running
`0`	Inactive — deactivated or paused

Pagination

Increment offset by limit to retrieve the next page.

# Page 2 with 20 results per page
curl "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/experiments?limit=20&offset=20" \
  -H "Authorization: Bearer YOUR_GENERATED_API_KEY"

Error responses

Status	Meaning
`401`	Invalid or missing API key

Next step

Use the test_id from this response to call Get Experiment Details or Get Experiment Result.

Query parameters​

Example​

Success response​

Response fields​

Status values​

Pagination​

Error responses​