Skip to navigation
HeyReach APILists

GetListsForLead

View as Markdown

Gets Lists for a Lead

This endpoint retrieves the lists associated with a specific lead.

Remark: The response will include lead lists that match the provided lead details such as email, LinkedIn ID, or profile URL.

Body Parameters

  • email (string, optional): The email address of the lead.

  • linkedinId (string, optional): The LinkedIn ID of the lead.

  • profileUrl (string, optiona;): The LinkedIn profile URL of the lead. For example: https://www.linkedin.com/in/john_doe/

  • offset (integer): The number of records to skip (for pagination).

  • limit (integer): The maximum number of records to return.

Headers

X-API-KEYstringOptional

API key header using this scheme. Example: “X-API-KEY: {API_KEY}”

Request

This endpoint expects an object.
emailstringRequiredformat: "email"
linkedinIdstringRequired
profileUrlstringRequiredformat: "uri"
offsetintegerRequired
limitintegerRequired

Response

OK
totalCountinteger
itemslist of objects