List all deals

get

https://{youraccountname}.api-us1.com/api/3/deals

Retrieve all existing deals

Query Params

filters[search]

string

Search text to use with search_field parameter.

filters[search_field]

string

Field to search for. See available values.

filters[title]

string

Filter by deal's title

filters[stage]

int32

Filter by deal's stage

filters[group]

int32

Filter by deal's pipeline

filters[status]

int32

Filter by deal's status. See available values

filters[owner]

int32

Filter by deal's owner

filters[nextdate_range]

string

Filter by deal's tasks due dates. See available values

filters[tag]

string

Filter by tag names associated with deal's primary contact. See available values.

filters[tasktype]

string

Filter by deals that have tasks with given type

filters[created_before]

date

Returns deals that are created less than given date

filters[created_after]

date

Returns deals that are created greater than or equal to given date

filters[updated_before]

date

Returns deals that are updated less than given date

filters[updated_after]

date

Returns deals that are updated greater than or equal to given date

filters[organization]

int32

Filter by deal's primary contact's organization's id

filters[minimum_value]

int32

In USD with dollar portion. Returns deals whose values are greater than or equal to given value

filters[maximum_value]

int32

In USD with dollar portion. Returns deals whose values are less than or equal to given value

filters[score_greater_than]

string

In a format of <score_id>:<score_value>. Returns deals whose score value is greater than given value

filters[score_less_than]

string

In a format of <score_id>:<score_value>. Returns deals whose score value is less than given value

filters[score]

string

In a format of <score_id>:<score_value>. Returns deals whose score value is equal to given value

orders[title]

string

Defaults to ASC

Order by deal's title.

orders[value]

string

Defaults to ASC

Order by deal's value.

orders[cdate]

string

Defaults to ASC

Order by deal's created date.

orders[contact_name]

string

Defaults to ASC

Order by deal's primary contact's first name.

orders[contact_orgname]

string

Defaults to ASC

Order by deal's primary contact's organization name.

orders[next-action]

string

Defaults to ASC

Order by deal's next task's due date first. Then append deals with no next task. Lastly append deals with overdue tasks. If dates are the same, order by deal's id.

Responses

Language

Credentials

Header

URL

Loading…

Response

Choose an example:

application/json

200200

400400