---
title: "GET /api/builder/domains/published/by_id/{builder_id}/"
method: GET
path: "/api/builder/domains/published/by_id/{builder_id}/"
tags: ["Builder public"]
---

# GET /api/builder/domains/published/by_id/{builder_id}/

`GET /api/builder/domains/published/by_id/{builder_id}/`

Returns the public serialized version of the builder and its pages for the given builder id.

## Path parameters

- `builder_id` integer, required

## Response `200`

- PublicApplicationApplication — Change the workspace to add licences.
  - `id` integer, required
  - `name` string, required
  - `order` integer, required
  - `type` string, required
  - `workspace` string, required
  - `created_on` string, date-time, required
  - `favicon_file` UserFile
    - `size` integer, required
    - `mime_type` string
    - `is_image` boolean
    - `image_width` integer, nullable
    - `image_height` integer, nullable
    - `uploaded_at` string, date-time, required
    - `url` string, uri, required
    - `thumbnails` object, required
    - `name` string, required
    - `original_name` string, required
  - `login_page_id` integer, nullable — The login page for this application. This is related to the visibility settings of builder pages.
  - `breakpoints` object — The maximum widths in pixels for the responsive layouts, between 320 and 1920 pixels. Mobile and tablet breakpoints are required.
  - `pages` PublicPage[], required — This field is specific to the `builder` application and contains an array of pages that are in the builder.
    - `id` integer, required
    - `name` string, required
    - `path` string, required
    - `path_params` PathParam[]
      - `name` string, required — The name of the parameter.
      - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric
    - `shared` boolean
    - `visibility` 'all' | 'logged-in' — * `all` - All * `logged-in` - Logged In
    - `role_type` 'allow_all' | 'allow_all_except' | 'disallow_all_except' — * `allow_all` - Allow All * `allow_all_except` - Allow All Except * `disallow_all_except` - Disallow All Except
    - `roles` unknown
    - `query_params` QueryParam[]
      - `name` string, required — The name of the parameter.
      - `type` 'text' | 'numeric', required — * `text` - text * `numeric` - numeric
    - `graph` unknown, required
  - `theme` ColorTypographyButtonImagePageInputTableLinklinkActiveTextDecoration, required
    - `primary_color` string
    - `secondary_color` string
    - `border_color` string
    - `main_success_color` string
    - `main_warning_color` string
    - `main_error_color` string
    - `custom_colors` unknown
    - `heading_1_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `heading_2_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `heading_3_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `heading_4_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `heading_5_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `heading_6_text_decoration` boolean[] — Text decoration: [underline, stroke, uppercase, italic]
    - `body_font_family` string
    - `body_font_size` integer
    - `body_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `body_text_color` string
    - `body_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_1_font_family` string
    - `heading_1_font_size` integer
    - `heading_1_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_1_text_color` string
    - `heading_1_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_2_font_family` string
    - `heading_2_font_size` integer
    - `heading_2_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_2_text_color` string
    - `heading_2_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_3_font_family` string
    - `heading_3_font_size` integer
    - `heading_3_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_3_text_color` string
    - `heading_3_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_4_font_family` string
    - `heading_4_font_size` integer
    - `heading_4_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_4_text_color` string
    - `heading_4_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_5_font_family` string
    - `heading_5_font_size` integer
    - `heading_5_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_5_text_color` string
    - `heading_5_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `heading_6_font_family` string
    - `heading_6_font_size` integer
    - `heading_6_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `heading_6_text_color` string
    - `heading_6_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `button_font_family` string
    - `button_font_size` integer
    - `button_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `button_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `button_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `button_width` 'auto' | 'full' — * `auto` - Auto * `full` - Full
    - `button_background_color` string — The background color of buttons
    - `button_text_color` string — The text color of buttons
    - `button_border_color` string — The border color of buttons
    - `button_border_size` integer — Button border size
    - `button_border_radius` integer — Button border radius
    - `button_vertical_padding` integer — Button vertical padding
    - `button_horizontal_padding` integer — Button horizontal padding
    - `button_hover_background_color` string — The background color of buttons when hovered
    - `button_hover_text_color` string — The text color of buttons when hovered
    - `button_hover_border_color` string — The border color of buttons when hovered
    - `button_active_background_color` string — The background color of buttons when active
    - `button_active_text_color` string — The text color of buttons when active
    - `button_active_border_color` string — The border color of buttons when active
    - `image_max_height` integer — The image max height
    - `image_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `image_max_width` integer — The max-width for this image element.
    - `image_border_radius` integer — The border radius for this image element.
    - `image_constraint` 'cover' | 'contain' | 'full-width' — * `cover` - Cover * `contain` - Contain * `full-width` - Full Width
    - `page_background_file` UserFile
      - `size` integer, required
      - `mime_type` string
      - `is_image` boolean
      - `image_width` integer, nullable
      - `image_height` integer, nullable
      - `uploaded_at` string, date-time, required
      - `url` string, uri, required
      - `thumbnails` object, required
      - `name` string, required
      - `original_name` string, required
    - `page_background_color` string — The background color of the page
    - `page_background_mode` 'tile' | 'fill' | 'fit' — * `tile` - Tile * `fill` - Fill * `fit` - Fit
    - `label_font_family` string — The font family of the label
    - `label_text_color` string — The text color of the label
    - `label_font_size` integer — The font size of the label
    - `label_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `input_font_family` string — The font family of the input
    - `input_font_size` integer
    - `input_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `input_text_color` string — The text color of the input
    - `input_background_color` string — The background color of the input
    - `input_border_color` string — The color of the input border
    - `input_border_size` integer — Input border size
    - `input_border_radius` integer — Input border radius
    - `input_vertical_padding` integer — Input vertical padding
    - `input_horizontal_padding` integer — Input horizontal padding
    - `table_border_color` string — The color of the table border
    - `table_border_size` integer — Table border size
    - `table_border_radius` integer — Table border radius
    - `table_header_background_color` string — The background color of the table header cells
    - `table_header_text_color` string — The text color of the table header cells
    - `table_header_font_size` integer — The font size of the header cells
    - `table_header_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `table_header_font_family` string — The font family of the table header cells
    - `table_header_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `table_cell_background_color` string — The background color of the table cells
    - `table_cell_alternate_background_color` string — The alternate background color of the table cells
    - `table_cell_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `table_cell_vertical_padding` integer — Table cell vertical padding
    - `table_cell_horizontal_padding` integer — Table cell horizontal padding
    - `table_vertical_separator_color` string — The color of the table vertical separator
    - `table_vertical_separator_size` integer — Table vertical separator size
    - `table_horizontal_separator_color` string — The color of the table horizontal separator
    - `table_horizontal_separator_size` integer — Table horizontal separator size
    - `link_default_text_decoration` boolean[] — Default text decoration: [underline, stroke, uppercase, italic]
    - `link_hover_text_decoration` boolean[] — Hover text decoration: [underline, stroke, uppercase, italic]
    - `link_active_text_decoration` boolean[] — Active text decoration: [underline, stroke, uppercase, italic]
    - `link_font_family` string
    - `link_font_size` integer
    - `link_font_weight` 'thin' | 'extra-light' | 'light' | 'regular' | 'medium' | 'semi-bold' | 'bold' | 'extra-bold' | 'heavy' | 'black' | 'extra-black' — * `thin` - Thin * `extra-light` - Extra Light * `light` - Light * `regular` - Regular * `medium` - Medium * `semi-bold` - Semi Bold * `bold` - Bold * `extra-bold` - Extra Bold * `heavy` - Heavy * `black` - Black * `extra-black` - Extra Black
    - `link_text_alignment` 'left' | 'center' | 'right' — * `left` - Left * `center` - Center * `right` - Right
    - `link_text_color` string — The text color of links
    - `link_hover_text_color` string — The hover color of links when hovered
    - `link_active_text_color` string — The hover color of links when active
  - `user_sources` UserSourceBasePublicUserSource[], required — The user sources related with this builder.
    - `id` integer, required
    - `uid` string, required — Unique id for this user source.
    - `type` string, required — The type of the user_source.
    - `name` string, required
    - `order` string, decimal, required — Lowest first.
    - `auth_providers` AppAuthProviderAppAuthProvider[] — Auth providers related to this user source.
      - union
        - LocalBaserowPasswordAppAuthProviderAppAuthProvider — Basic app_auth_provider serializer mostly for returned values.
          - `type` string, required — The type of the app_auth_provider.
          - `id` integer, required
          - `domain` string, nullable — The email domain registered with this provider.
          - `password_field_id` integer, nullable — The id of the field to use as password for the user account.
        - SamlAppAuthProviderModelAppAuthProvider — Basic app_auth_provider serializer mostly for returned values.
          - `type` string, required — The type of the app_auth_provider.
          - `id` integer, required
          - `domain` string, nullable — The email domain registered with this provider.
          - `metadata` string, required — The SAML metadata XML provided by the IdP.
          - `is_verified` boolean, required — Whether or not a user sign in correctly with this SAML provider.
          - `email_attr_key` string — The key in the SAML response that contains the email address of the user.
          - `first_name_attr_key` string — The key in the SAML response that contains the first name of the user.
          - `last_name_attr_key` string — The key in the SAML response that contains the last name of the user. If this is not set, the first name attr will be used as full name.
        - OpenIdConnectAppAuthProviderModelAppAuthProvider — Basic app_auth_provider serializer mostly for returned values.
          - `type` string, required — The type of the app_auth_provider.
          - `id` integer, required
          - `domain` string, nullable — The email domain registered with this provider.
          - `name` string, required
          - `base_url` string, required — The provider base url.
          - `client_id` string, required — App ID, or consumer key
          - `secret` string, required — API secret, client secret, or consumer secret
          - `use_id_token` boolean — Whether to use the id_token instead of user_info endpoint to get user data
          - `email_attr_key` string — The name of the claim that contains the email address of the user.
          - `first_name_attr_key` string — The key in the OIDC response that contains the first name of the user.
          - `last_name_attr_key` string — The key in the OIDC response that contains the last name of the user. If empty in response, first name will be used.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `email_field_id` integer, nullable — The id of the field to use as email for the user account.
    - `name_field_id` integer, nullable — The id of the field that contains the user name.
    - `role_field_id` integer, nullable — The id of the field that contains the user role.
  - `scripts` CustomScript[], required — Scripts to embed for this application
    - `id` integer, required
    - `type` 'stylesheet' | 'javascript' — * `stylesheet` - Stylesheet * `javascript` - JavaScript
    - `url` string, uri — The URL of the script.
    - `load_type` union — The load type of the script. * `` - None * `defer` - Defer * `async` - Async
      - 'defer' | 'async' — * `` - None * `defer` - Defer * `async` - Async
      - ''
    - `crossorigin` union — The Crossorigin type of the script. * `` - None * `anonymous` - Anonymous * `credentials` - Use credentials
      - 'anonymous' | 'credentials' — * `` - None * `anonymous` - Anonymous * `credentials` - Use credentials
      - ''
  - `custom_code` CustomCode, required
    - `css` string — Custom CSS code.
    - `js` string — Custom JavaScript code.

## Other responses

- `404`

## Changes

- **2026-08-27** `f3396317d932` — 1 info
  - added the optional property `oneOf[#/components/schemas/PublicNone]/breakpoints` to the response with the `200` status

[Change history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/builder/domains/published/by_id/:builder_id/get.md)

---

[API](https://skmtc.dev/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.dev/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/f3396317d932/schema)
