Get all leads

GET {{baseUrl}}/leads?limit=<integer>&start=<integer>&archived_status=<string>&owner_id=<integer>&person_id=<integer>&organization_id=<integer>&filter_id=<integer>&sort=<string>

Returns multiple leads. Leads are sorted by the time they were created, from oldest to newest. Pagination can be controlled using limit and start query parameters. If a lead contains custom fields, the fields' values will be included in the response in the same format as with the Deals endpoints. If a custom field's value hasn't been set for the lead, it won't appear in the response. Please note that leads do not have a separate set of custom fields, instead they inherit the custom fields' structure from deals.

Request Params

KeyDatatypeRequiredDescription
limitstringFor pagination, the limit of entries to be returned. If not provided, 100 items will be returned.
startstringFor pagination, the position that represents the first result for the page
archived_statusstringFiltering based on the archived status of a lead. If not provided, All is used.
owner_idstringIf supplied, only leads matching the given user will be returned. However, filter_id takes precedence over owner_id when supplied.
person_idstringIf supplied, only leads matching the given person will be returned. However, filter_id takes precedence over person_id when supplied.
organization_idstringIf supplied, only leads matching the given organization will be returned. However, filter_id takes precedence over organization_id when supplied.
filter_idstringThe ID of the filter to use
sortstringThe field names and sorting mode separated by a comma (field_name_1 ASC, field_name_2 DESC). Only first-level field keys are supported (no nested keys).

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;success&quot;:true,&quot;data&quot;:[{&quot;id&quot;:&quot;adf21080-0e10-11eb-879b-05d71fb426ec&quot;,&quot;title&quot;:&quot;Jane Doe Lead&quot;,&quot;owner_id&quot;:1,&quot;creator_id&quot;:1,&quot;label_ids&quot;:[&quot;f08b42a0-4e75-11ea-9643-03698ef1cfd6&quot;,&quot;f08b42a1-4e75-11ea-9643-03698ef1cfd6&quot;],&quot;person_id&quot;:1092,&quot;organization_id&quot;:null,&quot;source_name&quot;:&quot;API&quot;,&quot;origin&quot;:&quot;API&quot;,&quot;origin_id&quot;:null,&quot;channel&quot;:52,&quot;channel_id&quot;:&quot;Jun23 Billboards&quot;,&quot;is_archived&quot;:false,&quot;was_seen&quot;:false,&quot;value&quot;:{&quot;amount&quot;:999,&quot;currency&quot;:&quot;USD&quot;},&quot;expected_close_date&quot;:null,&quot;next_activity_id&quot;:1,&quot;add_time&quot;:&quot;2020-10-14T11:30:36.551Z&quot;,&quot;update_time&quot;:&quot;2020-10-14T11:30:36.551Z&quot;,&quot;visible_to&quot;:&quot;3&quot;,&quot;cc_email&quot;:&quot;company+1+leadntPaYKA5QRxXkh6WMNHiGh@dev.pipedrivemail.com&quot;}]}