---
title: "List landing pages reports"
method: GET
path: "/3.0/reporting/landing-pages"
tags: ["reporting"]
---

# List landing pages reports

`GET /3.0/reporting/landing-pages`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/reporting/landing-pages`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/reporting/landing-pages/get.ts> (a function with typed inputs; its response is checked against the schema)

Get reports of landing pages.

## Query parameters

- `fields` string[]
- `exclude_fields` string[]
- `count` integer
- `offset` integer

## Response `200`

List of Landing Page Report Instances

- object: A collection of landing pages.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `landing_pages` object[]
    - `_links` object[]: A list of link types and descriptions for the API schema documents.
      - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
      - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
      - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
      - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
    - `clicks` integer: The number of clicks to this landing pages.
    - `conversion_rate` number: The percentage of people who visited your landing page and were added to your list.
    - `ecommerce` object
      - `average_order_revenue` number: The average order revenue of this landing page.
      - `currency_code` string: The user's currency code.
      - `total_orders` integer: The total number of orders associated with this landing page.
      - `total_revenue` number: The total revenue of this landing page.
    - `id` string: A string that uniquely identifies this landing page.
    - `list_id` string: The list id connected to this landing page.
    - `list_name` string: List Name
    - `name` string: The name of this landing page the user will see.
    - `published_at` string, date-time: The time this landing page was published.
    - `signup_tags` object[]: A list of tags associated to the landing page.
      - `tag_id` integer: The unique id for the tag.
      - `tag_name` string: The name of the tag.
    - `status` string: The status of the landing page.
    - `subscribes` integer: The number of subscribes to this landing pages.
    - `timeseries` object
      - `daily_stats` object: The clicks and visits data from the last seven days.
        - `clicks` object[]
          - `date` string
          - `val` integer
        - `unique_visits` object[]
          - `date` string
          - `val` integer
        - `visits` object[]
          - `date` string
          - `val` integer
      - `weekly_stats` object: The clicks and visits data from the last five weeks.
        - `clicks` object[]: The total number of clicks in a week.
          - `date` string
          - `val` integer
        - `unique_visits` object[]
          - `date` string
          - `val` integer
        - `visits` object[]: The total number of visits in a week.
          - `date` string
          - `val` integer
    - `title` string: The name of the landing page the user's customers will see.
    - `unique_visits` integer: The number of unique visits to this landing pages.
    - `unpublished_at` string, date-time: The time this landing page was unpublished.
    - `url` string: The landing page url.
    - `visits` integer: The number of visits to this landing pages.
    - `web_id` integer: The ID used in the Mailchimp web application.
  - `total_items` integer: The total number of items matching the query regardless of pagination.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)