# Return branding file content from the active theme

This function retrieves and renders a branding file from the active theme.
The file may be a Template Toolkit (.tt) file or a standard HTML/image
file. When the file is a Template Toolkit file, the system processes it
and returns the rendered output. Otherwise, the system returns the file's
raw or HTML-encoded content.

Endpoint: GET /Branding/include
Version: 11.138.0.19
Security: BasicAuth

## Query parameters:

  - `file` (string, required)
    The relative path to the branding file within the theme directory.
    Example: "header.tt"

  - `data` (string)
    A JSON-encoded object containing additional variables to pass to the
Template Toolkit template when rendering a .tt file. This parameter
is ignored for non-template files.
    Example: "{\"logoColor\":\"blue\",\"showBanner\":1}"

  - `raw` (integer)
    Whether to return the raw file content without HTML encoding.

* 1 — Return the raw file content.
* 0 — Return HTML-encoded content. This is the default behavior.

This parameter has no effect when the file is a Template Toolkit (.tt) file.
    Enum: 0, 1

  - `skip_default` (integer)
    Whether to skip the default branding fallback.

* 1 — Do not fall back to the default branding file if the theme-specific
  file does not exist. This parameter has no effect for accounts that do not
  have a branding package assigned; the theme fallback is always applied in
  that case.
* 0 — Fall back to the default branding file. This is the default behavior.
    Enum: 0, 1

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "include"

  - `module` (string)
    The name of the module called.
    Example: "Branding"

  - `result` (object)

  - `result.data` (string,null)
    The rendered or retrieved content of the requested branding file.
For Template Toolkit files, this is the processed template output.
For other files, this is the raw or HTML-encoded file content.
    Example: "<div class=\"header\">Welcome</div>"

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    - 1 - Success.
- 0 - Failed. Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.