9. Retrieve past leads looking back 90 days

GET {{baseUrl}}/adFormResponses?q=account&account=urn%3Ali%3AsponsoredAccount%3A{{sponsoredaccount_id}}&projection=(paging,elements*(id,leadType,account~(id,name,reference~(localizedName)),campaign~(id,name),creative~(id,variables(data((,share~(text))))),form~(form(landingPage,hiddenFields,name)),formResponse(consentResponses*(accepted,consent~),submittedAt,answers*(question~,answerDetails))))&timeRange=(start:1668283699000,end:1668456499000)

The user may have already started receiving leads prior to setting up the integration with your platform. Allowing the user to backfill these leads ensures their chosen destination is up to date.

Using the same call from the previous step, you can use the timeRange.start and timeRange.end params to pull leads as far back as 90 days.

Request Params

KeyDatatypeRequiredDescription
qstring
accountstring
projectionstring
timeRangestring

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring
LinkedIn-Versionstring
X-Restli-Protocol-Versionstring

RESPONSES

status: OK

{"paging":{"total":2,"start":0,"count":10,"links":[]},"elements":[{"creative~":{"variables":{"data":{"com.linkedin.ads.SponsoredUpdateCreativeVariables":{"contentAuthor":{"organization":"urn:li:organization:73841066"},"activity":"urn:li:activity:6975908550300585984","callToActionEnabled":true,"sponsoredStatusUpdateContentType":"ARTICLE","mediaAspectRatio":{"widthAspect":1.754386,"heightAspect":1.0},"share":"urn:li:share:6975908549293928448","share~":{"text":{"text":"howdy there!"}},"directSponsoredContent":true}}},"id":241112256},"form~":{"form":{"name":"spanish with custom questions","hiddenFields":[],"landingPage":"https://www.linkedin.com"}},"account~":{"name":"Christa's Updated Ad Acount","reference":"urn:li:organization:73841066","id":508679858,"reference~":{"localizedName":"Highlander Cranberries LLC"}},"creative":"urn:li:sponsoredCreative:241112256","form":"urn:li:adForm:7149286","leadType":"SPONSORED","campaign":"urn:li:sponsoredCampaign:198356826","campaign~":{"name":"Spain campaign","id":198356826},"id":"urn:li:adFormResponse:0cd561e8-8654-4cc0-9d9c-03cf7f50520a-6","account":"urn:li:sponsoredAccount:508679858","formResponse":{"answers":[{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,3)","question~":{"questionId":3,"question":"Correo electrónico","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Email address","predefinedField":"EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,5)","question~":{"questionId":5,"question":"Correo electrónico del trabajo","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Work email","predefinedField":"WORK_EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,6)","question~":{"questionId":6,"question":"favorite color","typeSpecificQuestionDetails":{"com.linkedin.ads.MultipleChoiceQuestionDetails":{"options":[{"com.linkedin.ads.TextOptionQuestion":{"text":"red"}},{"com.linkedin.ads.TextOptionQuestion":{"text":"green"}}]}},"name":"Custom question 0"},"answerDetails":{"com.linkedin.ads.MultipleChoiceAnswer":{"options":[{"com.linkedin.ads.TextOptionAnswer":{"index":1}}]}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,1)","question~":{"questionId":1,"question":"Nombre","memberProfileField":"FIRST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"First name","predefinedField":"FIRST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Christa"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,2)","question~":{"questionId":2,"question":"Apellidos","memberProfileField":"LAST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Last name","predefinedField":"LAST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Brehm"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7149286,4)","question~":{"questionId":4,"question":"Cargo","memberProfileField":"JOB_TITLE","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Job title","predefinedField":"JOB_TITLE"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Senior Partner Engineer"}}}],"consentResponses":[],"submittedAt":1677549476277}},{"creative~":{"variables":{"data":{"com.linkedin.ads.SponsoredUpdateCreativeVariables":{"contentAuthor":{"organization":"urn:li:organization:73841066"},"activity":"urn:li:activity:6904869836686544896","callToActionEnabled":false,"sponsoredStatusUpdateContentType":"IMAGE","mediaAspectRatio":{"widthAspect":1.5037594,"heightAspect":1.0},"share":"urn:li:share:6904869836015464450","share~":{"text":{"text":"Sleepy cat"}},"directSponsoredContent":true}}},"id":241257736},"form~":{"form":{"name":"Form with written spanish","hiddenFields":[{"name":"hidden_field","value":"abc678"},{"name":"campo_escondido","value":"def789"}],"landingPage":"https://www.linkedin.com"}},"account~":{"name":"Christa's Updated Ad Acount","reference":"urn:li:organization:73841066","id":508679858,"reference~":{"localizedName":"Highlander Cranberries LLC"}},"creative":"urn:li:sponsoredCreative:241257736","form":"urn:li:adForm:7234246","leadType":"SPONSORED","campaign":"urn:li:sponsoredCampaign:198356826","campaign~":{"name":"Spain campaign","id":198356826},"id":"urn:li:adFormResponse:ed31e922-0d3f-4eb6-b6a4-603d32a8752d-6","account":"urn:li:sponsoredAccount:508679858","formResponse":{"answers":[{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,3)","question~":{"questionId":3,"question":"Correo electrónico","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Email address","predefinedField":"EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,6)","question~":{"questionId":6,"question":"Correo electrónico del trabajo","memberProfileField":"EMAIL","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Work email","predefinedField":"WORK_EMAIL"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"cbrehm@linkedin.com"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,7)","question~":{"questionId":7,"question":"Cuál es tu color favorito","typeSpecificQuestionDetails":{"com.linkedin.ads.MultipleChoiceQuestionDetails":{"options":[{"com.linkedin.ads.TextOptionQuestion":{"text":"Rojo"}},{"com.linkedin.ads.TextOptionQuestion":{"text":"Azul"}}]}},"name":"Custom question 0"},"answerDetails":{"com.linkedin.ads.MultipleChoiceAnswer":{"options":[{"com.linkedin.ads.TextOptionAnswer":{"index":0}}]}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,8)","question~":{"questionId":8,"question":"¿Dónde creciste?","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Custom question 1"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"En los Estados Unidos"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,1)","question~":{"questionId":1,"question":"Nombre","memberProfileField":"FIRST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"First name","predefinedField":"FIRST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Christa"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,2)","question~":{"questionId":2,"question":"Apellidos","memberProfileField":"LAST_NAME","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Last name","predefinedField":"LAST_NAME"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Brehm"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,4)","question~":{"questionId":4,"question":"Cargo","memberProfileField":"JOB_TITLE","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Job title","predefinedField":"JOB_TITLE"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Senior Partner Engineer"}}},{"question":"urn:li:adFormQuestion:(urn:li:adForm:7234246,5)","question~":{"questionId":5,"question":"Función","memberProfileField":"JOB_FUNCTION","typeSpecificQuestionDetails":{"com.linkedin.ads.TextQuestionDetails":{}},"name":"Function","predefinedField":"JOB_FUNCTION"},"answerDetails":{"com.linkedin.ads.TextQuestionAnswer":{"answer":"Ingeniería"}}}],"consentResponses":[{"accepted":true,"consent":"urn:li:adFormConsent:(urn:li:adForm:7234246,0)","consent~":{"consentId":0,"consentRequired":true,"content":" marque mi casilla de verificación personalizada!"}}],"submittedAt":1677549459303}}]}