Filter by opportunity status. all means no status filter, the same as leaving status out. (On POST /opportunities/search, all is not special: a status filter with all matches only opportunities stored with that value, so leave the status filter out to get every status.)
Available optionsopenwonlostabandonedall
Example:open
campaignIdstring
Campaign Id
Example:Y2I9XM7aO1hncuSOlc9L
idstring
Opportunity Id
Example:123akv4LFn6C9frZoy3e
orderstring
Sort order by date added: added_desc (default) or added_asc. desc and asc are accepted as aliases.
Available optionsadded_ascadded_descascdesc
Example:added_asc
endDatestring
End date: MM-DD-YYYY (optionally followed by HH:mm:ss) or epoch milliseconds. A date without a time covers the whole day.
Example:11-30-2026
startAfterstring
Cursor timestamp (epoch ms) for pagination.
Example:1628008053263
startAfterIdstring
Start After Id
Example:UIaE1WjAwWKdlyD7osQI
datestring
Start date: MM-DD-YYYY (optionally followed by HH:mm:ss) or epoch milliseconds
Example:11-01-2026
countrystring
Country code (ISO 3166-1 alpha-2) used to read a phone number in q. Not a filter. Defaults to US.
Example:US
pagenumber
Page number, starting at 1. Cannot be combined with startAfter. page * limit cannot exceed 10,000; use startAfter and startAfterId to read further.
Default:1
Example:1
limitnumber
Results per page, up to 100. 0 or absent means 20.
Same value as pipelineStageId, kept for older clients. Search results only.
Example:e93ba61a-53b3-45e7-985a-c7732dbcdb69
opportunities[].relationsobject[]
Records linked to the opportunity through associations. Search results only. When the opportunity has a contact, this always includes the primary contact relation (associationIdOPPORTUNITIES_CONTACTS_ASSOCIATION, primary: true, objectKeycontact, recordId the contact id).
opportunities[].attributionsobject[]
Attribution sessions recorded for the opportunity (first and last touch). Search results only; an empty list when there are none.
opportunities[].sortobject[]
Sort values of this opportunity in the result set. To get the next page of POST /opportunities/search, send the sort of the last opportunity as searchAfter, unchanged. Search results only.