Get lead forms

GET {{baseUrl}}/ad_accounts/:ad_account_id/lead_forms?page_size=25&order=DESCENDING&bookmark=<string>

Gets all Lead Forms associated with an ad account ID. This endpoint is in beta and not available to all advertisers. Learn more.

Request Params

KeyDatatypeRequiredDescription
page_sizenumberMaximum number of items to include in a single page of the response. See documentation on <a href='/docs/getting-started/pagination/'>Pagination</a> for more information.
orderstringThe order in which to sort the items returned: “ASCENDING” or “DESCENDING”
by ID. Note that higher-value IDs are associated with more-recently added
items.
bookmarkstringCursor used to fetch the next page of items

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;privacy_policy_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_accepted_terms&quot;:&quot;\u003cboolean\u003e&quot;,&quot;completion_message&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;disclosure_language&quot;:&quot;\u003cstring\u003e&quot;,&quot;questions&quot;:[{&quot;question_type&quot;:&quot;AGE&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_AREA&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;CUSTOM&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;AGE&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;FULL_NAME&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;PREFERRED_CONTACT_METHOD&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;ZIP_CODE&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;AGE&quot;,&quot;custom_question_field_type&quot;:&quot;RADIO_LIST&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;LAST_NAME&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;CUSTOM&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;STATE_PROVINCE&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}],&quot;id&quot;:&quot;9894724&quot;,&quot;ad_account_id&quot;:&quot;99550&quot;,&quot;created_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_time&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;privacy_policy_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_accepted_terms&quot;:&quot;\u003cboolean\u003e&quot;,&quot;completion_message&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;disclosure_language&quot;:&quot;\u003cstring\u003e&quot;,&quot;questions&quot;:[{&quot;question_type&quot;:&quot;FULL_NAME&quot;,&quot;custom_question_field_type&quot;:&quot;RADIO_LIST&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;CITY&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;COUNTRY&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;STATE_PROVINCE&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;STATE_PROVINCE&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;GENDER&quot;,&quot;custom_question_field_type&quot;:null,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;CUSTOM&quot;,&quot;custom_question_field_type&quot;:null,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;CITY&quot;,&quot;custom_question_field_type&quot;:&quot;DROPDOWN&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;PREFERRED_CONTACT_METHOD&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_AREA&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;question_type&quot;:&quot;EMAIL&quot;,&quot;custom_question_field_type&quot;:&quot;TEXT_FIELD&quot;,&quot;custom_question_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_question_options&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}],&quot;id&quot;:&quot;921956858&quot;,&quot;ad_account_id&quot;:&quot;755&quot;,&quot;created_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_time&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;bookmark&quot;:&quot;\u003cstring\u003e&quot;}