List hypotheses within a project

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/hypotheses

Retrieves a list of all hypotheses defined for a specific project. A hypothesis is an assumption about a proposed change and its expected impact, forming the basis for an experiment. Supports filtering by status, score, name, and pagination. The Knowledge Base article "Hypotheses (Compass)" explains: "A hypothesis is an assumption that a proposed change in your website would lead to visitors taking the action that you want them to."

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project to which save/retrieved data is connected

Body Params

onlyCount

boolean

If set to true in a list request, the response will only contain the total count of matching items (extra.pagination.items_count) and will not include the actual item data. Useful for quickly getting totals without fetching full datasets.

results_per_page

integer | null

0 to 50

Defaults to 30

Specifies the maximum number of items to return in a single page of results. Used for pagination. Default is 30, maximum is 50.

sort_direction

string | null

enum

Defaults to desc

The direction for sorting the list results, based on the sort_by field.

asc: Ascending order (e.g., A-Z, 1-10, oldest to newest).
desc: Descending order (e.g., Z-A, 10-1, newest to oldest). Defaults to desc (newest/highest first) if not specified.

Allowed:

sort_by

string | null

enum

Defaults to id

A value to sort hypotheses by specific field(s)

Defaults to id if not provided

Allowed:

scoreMax

integer | null

enum

Defaults to 5

The maximum score for hypotheses which you would like to retrieve

Allowed:

scoreMin

integer | null

enum

Defaults to 0

The minimum score for hypotheses which you would like to retrieve

Allowed:

string | null

A search string that would be used to search against hypotheses's name or description

status

array of objects | null

The status of the hypotheses you'd like to be returned; one of the below can be provided

status

experiences

array of integers | null

The list of experience ID's used to filter the list of returned hypotheses

experiences

200A list of hypotheses defined within a project. Each entry includes the hypothesis ID, name, objective, prioritization score, status, and associated experiences/tags.

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.