# Get a lead form

Fetches a lead form. Works with Meta Ads and LinkedIn Ads.

```http
GET https://api.pozy.ai/v1/ads/lead-forms/{formId}
```

- Area: Ads / Lead Gen
- Auth: Authorization: Bearer pz_live_...

## Path parameters

- `formId` (string, required)

## Query parameters

- `accountId` (string, required)
- `fields` (string)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/ads/lead-forms/6da2ff1d8c680bca61eb524a?accountId=696e0b682d0a31188e7a2ba9" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/ads/lead-forms/6da2ff1d8c680bca61eb524a?accountId=696e0b682d0a31188e7a2ba9", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/ads/lead-forms/6da2ff1d8c680bca61eb524a",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "accountId": "696e0b682d0a31188e7a2ba9",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `status`, string
- `form`, object
  - one of: Meta Lead Form
    - `id`, string
    - `name`, string
    - `status`, string
    - `locale`, string
    - `created_time`, string (date-time)
    - `page_id`, string
    - `leads_count`, integer
    - `organic_leads_count`, integer
    - `expired_leads_count`, integer
    - `privacy_policy_url`, string (URL)
    - `follow_up_action_url`, string (URL)
    - `follow_up_action_text`, string
    - `question_page_custom_headline`, string
    - `is_optimized_for_quality`, boolean
    - `block_display_for_non_targeted_viewer`, boolean
    - `allow_organic_lead`, boolean
    - `tracking_parameters`, array of object
      - `key`, string
      - `value`, string
    - `legal_content`, object
      - `id`, string
      - `privacy_policy`, object
        - `url`, string (URL)
        - `link_text`, string
      - `custom_disclaimer`, object
    - `context_card`, object
      - `id`, string
      - `title`, string
      - `style`, string: One of `LIST_STYLE`, `PARAGRAPH_STYLE`
      - `content`, array of string
      - `button_text`, string
      - `cover_photo`, object
        - `id`, string
    - `thank_you_page`, object
      - `id`, string
      - `title`, string
      - `body`, string
      - `button_text`, string
      - `button_type`, string
      - `website_url`, string (URL)
      - `enable_messenger`, boolean
      - `status`, string
      - `lead_gen_use_case`, string
      - `business_phone_number`, string
      - `country_code`, string
    - `questions`, array of object
      - `id`, string
      - `key`, string
      - `label`, string
      - `type`, string
      - `inline_context`, string
      - `options`, array of object
        - `key`, string
        - `value`, string
      - `conditional_questions_group_id`, string
      - `conditional_questions_choices`, array of object
      - `dependent_conditional_questions`, array of object
  - one of: object

```json
{
  "status": "active",
  "form": {
    "id": "6bfebd43ddc270f6d2c56fc5",
    "name": "Acme",
    "status": "active",
    "locale": "en",
    "created_time": "2026-10-02T09:00:00.000Z",
    "page_id": "60cae484a825fef31dae565c",
    "leads_count": 42,
    "organic_leads_count": 42,
    "expired_leads_count": 42,
    "privacy_policy_url": "https://pozy.ai/media/example-1.jpg",
    "follow_up_action_url": "https://pozy.ai/media/example-1.jpg",
    "follow_up_action_text": "Hello from Pozy",
    "question_page_custom_headline": "string",
    "is_optimized_for_quality": true,
    "block_display_for_non_targeted_viewer": true,
    "allow_organic_lead": true,
    "tracking_parameters": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "legal_content": {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "privacy_policy": {
        "url": "https://pozy.ai/media/example-1.jpg",
        "link_text": "Hello from Pozy"
      },
      "custom_disclaimer": {}
    },
    "context_card": {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "title": "Launch day",
      "style": "LIST_STYLE",
      "content": [
        "Hello from Pozy"
      ],
      "button_text": "Hello from Pozy",
      "cover_photo": {
        "id": "6bfebd43ddc270f6d2c56fc5"
      }
    },
    "thank_you_page": {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "title": "Launch day",
      "body": "string",
      "button_text": "Hello from Pozy",
      "button_type": "string",
      "website_url": "https://pozy.ai/media/example-1.jpg",
      "enable_messenger": true,
      "status": "active",
      "lead_gen_use_case": "string",
      "business_phone_number": "+14155550123",
      "country_code": "string"
    },
    "questions": [
      {
        "id": "6bfebd43ddc270f6d2c56fc5",
        "key": "string",
        "label": "string",
        "type": "string",
        "inline_context": "Hello from Pozy",
        "options": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "conditional_questions_group_id": "6e6e6e3ea0b86d2d0dfe942e",
        "conditional_questions_choices": [
          {}
        ],
        "dependent_conditional_questions": [
          {}
        ]
      }
    ]
  }
}
```