---
title: "Get a Landing Page starting point"
method: GET
path: "/v1/starting-points/landing-pages/{starting_point_id}"
tags: ["Starting Points"]
---

# Get a Landing Page starting point

`GET /v1/starting-points/landing-pages/{starting_point_id}`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/starting-points/landing-pages/{starting_point_id}`
- Auth: HTTP bearer

Returns one Landing Page starting point with its definition, styles, and settings.

## Path parameters

- `starting_point_id` string, required

## Response `200`

Successful response

- object
  - `data` LandingPageStartingPoint, required
    - `id` string, required
    - `kind` 'email_template' | 'form' | 'landing_page', required
    - `name` string, required
    - `description` string
    - `display_format` string
    - `display_order` integer, required
    - `updated_at` string, date-time, required
    - `definition` LandingPageDefinition, required
      - `blocks` LandingPageBlock[], required
        - `id` string, required
        - `type` 'section' | 'heading' | 'paragraph' | 'blockquote' | 'image' | 'video' | 'countdown' | 'testimonial' | 'logo-strip' | 'faq' | 'divider' | 'icon' | 'button' | 'form', required
        - `content` string
        - `level` 1 | 2 | 3
        - `textAlign` 'left' | 'center' | 'right' | 'justify' | 'null', nullable
        - `highlightColor` string, nullable
        - `citation` string
        - `borderColor` string, nullable
        - `backgroundColor` string, nullable
        - `textColor` string, nullable
        - `src` string
        - `altText` string
        - `caption` string
        - `href` string
        - `borderRadius` 'none' | 'normal' | 'large' | 'custom'
        - `customBorderRadius` LandingPageBoxCorners
          - `topLeft` number, required
          - `topRight` number, required
          - `bottomRight` number, required
          - `bottomLeft` number, required
        - `title` string
        - `aspectRatio` '16:9' | '4:3' | '1:1' | '9:16'
        - `targetDate` string: The countdown target as an ISO 8601 date and time with an explicit UTC offset or Z suffix.
        - `label` string
        - `expiredMessage` string
        - `design` 'cards' | 'minimal' | 'inline' | 'card' | 'quote' | 'row' | 'grid' | 'bordered'
        - `accentColor` string, nullable
        - `align` 'left' | 'center' | 'right'
        - `quote` string
        - `name` string
        - `avatarUrl` string
        - `avatarAlt` string
        - `rating` number
        - `heading` string
        - `logos` LandingPageLogo[]
          - `id` string, required
          - `name` string, required
          - `imageUrl` string, required
          - `altText` string, required
          - `href` string
        - `logoHeight` number
        - `items` LandingPageFaqItem[]
          - `id` string, required
          - `question` string, required
          - `answer` string, required
        - `defaultOpenFirst` boolean
        - `iconPosition` 'start' | 'end'
        - `color` string, nullable
        - `thickness` number
        - `style` 'solid' | 'dashed' | 'dotted'
        - `iconName` string
        - `size` union
          - number
          - 'small' | 'medium' | 'large'
        - `cssClass` string
        - `cssId` string
        - `buttonTextColor` string
        - `borderWidth` 'none' | 'normal' | 'large' | 'custom'
        - `customBorderWidth` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `width` 'default' | 'large' | 'full' | 'fit'
        - `openInNewTab` boolean
        - `fields` FormField[]
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `disclaimerText` string
        - `fieldLayout` 'one-column' | 'two-column'
        - `submitLayout` 'stacked' | 'inline-email'
        - `styles` FormStyles
          - `formBackgroundColor` string
          - `textColor` string
          - `accentColor` string
          - `fieldBackgroundColor` string
          - `fieldBorderColor` string
          - `fieldTextColor` string
          - `errorTextColor` string
          - `formBorderColor` string
          - `buttonTextColor` string
          - `rowGap` number
          - `columnGap` number
          - `formBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
          - `formBorderWidthCustom` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `fieldBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
          - `fieldBorderWidthCustom` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `formBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `formBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `fieldBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `fieldBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `buttonBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `buttonBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `submitButtonLabel` string
          - `submitBehavior` 'message' | 'redirect'
          - `redirectUrl` string
          - `forwardSubscriberData` boolean
          - `forwardedSubscriberFields` string[]
          - `tagIds` string[]
          - `doubleOptIn` DoubleOptInSettings
            - `enabled` boolean
            - `confirmationEmailSubject` string, nullable: For Subscriber personalization in email subjects and body text nodes, use Mailrith bracket tokens such as [Subscriber_Name, fallback="friend"] or [Subscriber_Email, fallback=""]. Before using a custom field, call custom_fields_list or custom_fields_get and copy its personalization_token exactly. Do not use Handlebars-style variables such as {{ subscriber.name }}; Mailrith sends them as literal text.
            - `confirmationEmailBodyDocument` BroadcastEmailDocument
              - …
            - `confirmationSuccessBehavior` 'message' | 'redirect'
            - `confirmationSuccessMessage` string
            - `confirmationSuccessUrl` string, nullable
        - `columns` LandingPageColumn[]
          - `id` string, required
          - `blocks` LandingPageBlock[], required
          - `backgroundColor` string, nullable, required
          - `textColor` string, nullable, required
          - `backgroundImageUrl` string, nullable, required
          - `backgroundImageOverlayOpacity` number
          - `margin` 'none' | 'normal' | 'large' | 'custom', required
          - `padding` 'none' | 'normal' | 'large' | 'custom', required
          - `customMargin` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `customPadding` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `verticalAlign` 'top' | 'middle' | 'bottom', required
          - `borderColor` string, required
          - `borderWidth` 'none' | 'normal' | 'large' | 'custom', required
          - `borderRadius` 'none' | 'normal' | 'large' | 'custom', required
          - `customBorderWidth` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `customBorderRadius` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `visibility` LandingPageVisibility
            - `desktop` boolean, required
            - `tablet` boolean, required
            - `mobile` boolean, required
        - `backgroundImageUrl` string, nullable
        - `backgroundImageOverlayOpacity` number
        - `coverViewport` boolean
        - `margin` 'none' | 'normal' | 'large' | 'custom'
        - `padding` 'none' | 'normal' | 'large' | 'custom'
        - `customMargin` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `customPadding` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `visibility` LandingPageVisibility
          - `desktop` boolean, required
          - `tablet` boolean, required
          - `mobile` boolean, required
      - `successBlocks` LandingPageBlock[]
        - `id` string, required
        - `type` 'section' | 'heading' | 'paragraph' | 'blockquote' | 'image' | 'video' | 'countdown' | 'testimonial' | 'logo-strip' | 'faq' | 'divider' | 'icon' | 'button' | 'form', required
        - `content` string
        - `level` 1 | 2 | 3
        - `textAlign` 'left' | 'center' | 'right' | 'justify' | 'null', nullable
        - `highlightColor` string, nullable
        - `citation` string
        - `borderColor` string, nullable
        - `backgroundColor` string, nullable
        - `textColor` string, nullable
        - `src` string
        - `altText` string
        - `caption` string
        - `href` string
        - `borderRadius` 'none' | 'normal' | 'large' | 'custom'
        - `customBorderRadius` LandingPageBoxCorners
          - `topLeft` number, required
          - `topRight` number, required
          - `bottomRight` number, required
          - `bottomLeft` number, required
        - `title` string
        - `aspectRatio` '16:9' | '4:3' | '1:1' | '9:16'
        - `targetDate` string: The countdown target as an ISO 8601 date and time with an explicit UTC offset or Z suffix.
        - `label` string
        - `expiredMessage` string
        - `design` 'cards' | 'minimal' | 'inline' | 'card' | 'quote' | 'row' | 'grid' | 'bordered'
        - `accentColor` string, nullable
        - `align` 'left' | 'center' | 'right'
        - `quote` string
        - `name` string
        - `avatarUrl` string
        - `avatarAlt` string
        - `rating` number
        - `heading` string
        - `logos` LandingPageLogo[]
          - `id` string, required
          - `name` string, required
          - `imageUrl` string, required
          - `altText` string, required
          - `href` string
        - `logoHeight` number
        - `items` LandingPageFaqItem[]
          - `id` string, required
          - `question` string, required
          - `answer` string, required
        - `defaultOpenFirst` boolean
        - `iconPosition` 'start' | 'end'
        - `color` string, nullable
        - `thickness` number
        - `style` 'solid' | 'dashed' | 'dotted'
        - `iconName` string
        - `size` union
          - number
          - 'small' | 'medium' | 'large'
        - `cssClass` string
        - `cssId` string
        - `buttonTextColor` string
        - `borderWidth` 'none' | 'normal' | 'large' | 'custom'
        - `customBorderWidth` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `width` 'default' | 'large' | 'full' | 'fit'
        - `openInNewTab` boolean
        - `fields` FormField[]
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `disclaimerText` string
        - `fieldLayout` 'one-column' | 'two-column'
        - `submitLayout` 'stacked' | 'inline-email'
        - `styles` FormStyles
          - `formBackgroundColor` string
          - `textColor` string
          - `accentColor` string
          - `fieldBackgroundColor` string
          - `fieldBorderColor` string
          - `fieldTextColor` string
          - `errorTextColor` string
          - `formBorderColor` string
          - `buttonTextColor` string
          - `rowGap` number
          - `columnGap` number
          - `formBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
          - `formBorderWidthCustom` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `fieldBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
          - `fieldBorderWidthCustom` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `formBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `formBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `fieldBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `fieldBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `buttonBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
          - `buttonBorderRadiusCustom` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `submitButtonLabel` string
          - `submitBehavior` 'message' | 'redirect'
          - `redirectUrl` string
          - `forwardSubscriberData` boolean
          - `forwardedSubscriberFields` string[]
          - `tagIds` string[]
          - `doubleOptIn` DoubleOptInSettings
            - `enabled` boolean
            - `confirmationEmailSubject` string, nullable: For Subscriber personalization in email subjects and body text nodes, use Mailrith bracket tokens such as [Subscriber_Name, fallback="friend"] or [Subscriber_Email, fallback=""]. Before using a custom field, call custom_fields_list or custom_fields_get and copy its personalization_token exactly. Do not use Handlebars-style variables such as {{ subscriber.name }}; Mailrith sends them as literal text.
            - `confirmationEmailBodyDocument` BroadcastEmailDocument
              - …
            - `confirmationSuccessBehavior` 'message' | 'redirect'
            - `confirmationSuccessMessage` string
            - `confirmationSuccessUrl` string, nullable
        - `columns` LandingPageColumn[]
          - `id` string, required
          - `blocks` LandingPageBlock[], required
          - `backgroundColor` string, nullable, required
          - `textColor` string, nullable, required
          - `backgroundImageUrl` string, nullable, required
          - `backgroundImageOverlayOpacity` number
          - `margin` 'none' | 'normal' | 'large' | 'custom', required
          - `padding` 'none' | 'normal' | 'large' | 'custom', required
          - `customMargin` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `customPadding` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `verticalAlign` 'top' | 'middle' | 'bottom', required
          - `borderColor` string, required
          - `borderWidth` 'none' | 'normal' | 'large' | 'custom', required
          - `borderRadius` 'none' | 'normal' | 'large' | 'custom', required
          - `customBorderWidth` LandingPageBoxEdges
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
            - `left` number, required
          - `customBorderRadius` LandingPageBoxCorners
            - `topLeft` number, required
            - `topRight` number, required
            - `bottomRight` number, required
            - `bottomLeft` number, required
          - `visibility` LandingPageVisibility
            - `desktop` boolean, required
            - `tablet` boolean, required
            - `mobile` boolean, required
        - `backgroundImageUrl` string, nullable
        - `backgroundImageOverlayOpacity` number
        - `coverViewport` boolean
        - `margin` 'none' | 'normal' | 'large' | 'custom'
        - `padding` 'none' | 'normal' | 'large' | 'custom'
        - `customMargin` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `customPadding` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `visibility` LandingPageVisibility
          - `desktop` boolean, required
          - `tablet` boolean, required
          - `mobile` boolean, required
      - `customCss` string
    - `styles` LandingPageStyles, required
      - `headingFontFamily` string
      - `fontFamily` string
      - `fontSize` number
      - `backgroundColor` string
      - `textColor` string
      - `accentColor` string
    - `settings` LandingPageSettings, required
      - `seo` object
        - `title` string
        - `description` string
      - `social` object
        - `imageAssetId` string, nullable
        - `imageUrl` string
        - `altText` string
      - `analytics` object
        - `trackingCode` string
      - `form` FormStyles
        - `formBackgroundColor` string
        - `textColor` string
        - `accentColor` string
        - `fieldBackgroundColor` string
        - `fieldBorderColor` string
        - `fieldTextColor` string
        - `errorTextColor` string
        - `formBorderColor` string
        - `buttonTextColor` string
        - `rowGap` number
        - `columnGap` number
        - `formBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
        - `formBorderWidthCustom` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `fieldBorderWidthMode` 'none' | 'normal' | 'large' | 'custom'
        - `fieldBorderWidthCustom` LandingPageBoxEdges
          - `top` number, required
          - `right` number, required
          - `bottom` number, required
          - `left` number, required
        - `formBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
        - `formBorderRadiusCustom` LandingPageBoxCorners
          - `topLeft` number, required
          - `topRight` number, required
          - `bottomRight` number, required
          - `bottomLeft` number, required
        - `fieldBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
        - `fieldBorderRadiusCustom` LandingPageBoxCorners
          - `topLeft` number, required
          - `topRight` number, required
          - `bottomRight` number, required
          - `bottomLeft` number, required
        - `buttonBorderRadiusMode` 'none' | 'normal' | 'large' | 'custom'
        - `buttonBorderRadiusCustom` LandingPageBoxCorners
          - `topLeft` number, required
          - `topRight` number, required
          - `bottomRight` number, required
          - `bottomLeft` number, required
        - `submitButtonLabel` string
        - `submitBehavior` 'message' | 'redirect'
        - `redirectUrl` string
        - `forwardSubscriberData` boolean
        - `forwardedSubscriberFields` string[]
        - `tagIds` string[]
        - `doubleOptIn` DoubleOptInSettings
          - `enabled` boolean
          - `confirmationEmailSubject` string, nullable: For Subscriber personalization in email subjects and body text nodes, use Mailrith bracket tokens such as [Subscriber_Name, fallback="friend"] or [Subscriber_Email, fallback=""]. Before using a custom field, call custom_fields_list or custom_fields_get and copy its personalization_token exactly. Do not use Handlebars-style variables such as {{ subscriber.name }}; Mailrith sends them as literal text.
          - `confirmationEmailBodyDocument` BroadcastEmailDocument
            - `type` 'doc' | 'paragraph' | 'heading' | 'text' | 'hardBreak' | 'bulletList' | 'orderedList' | 'listItem' | 'blockquote' | 'emailSection' | 'emailSectionColumn' | 'emailButton' | 'image' | 'horizontalRule', required
            - `attrs` object
              - …
            - `content` BroadcastEmailNode[]
              - …
            - `text` string
            - `marks` BroadcastEmailMark[]
              - …
          - `confirmationSuccessBehavior` 'message' | 'redirect'
          - `confirmationSuccessMessage` string
          - `confirmationSuccessUrl` string, nullable
      - `display` FormDisplaySettings
        - `format` 'inline' | 'modal' | 'slide_in' | 'sticky_bar' | 'full_page'
        - `triggerType` 'exit_intent' | 'scroll_percentage' | 'timing_seconds' | 'click_trigger' | 'null', nullable
        - `scrollPercentage` integer, nullable
        - `timingSeconds` integer, nullable
        - `triggerClassName` string
        - `triggerId` string
        - `stickyBarPosition` 'top' | 'bottom' | 'null', nullable
        - `slideInPosition` 'left' | 'right' | 'null', nullable

## Other responses

- `404`: The Landing Page starting point was not found.

---

[API](https://skmtc.dev/mailrith/apis/mailrith-api.md) · [All operations](https://skmtc.dev/mailrith/apis/mailrith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailrith/apis/mailrith-api/revisions/41f09536f2da?raw)