---
title: "Workspace brand for the signing page"
method: GET
path: "/v1/sign/theme"
tags: ["Signing"]
---

# Workspace brand for the signing page

`GET /v1/sign/theme`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/sign/theme`
- Auth: API key in query parameter `signer-access-code`
- TypeScript: <https://skmtc.dev/assinafy/apis/assinafy-api-reference/docs/v1/sign/theme/get.ts> (a function with typed inputs; its response is checked against the schema)

The brand of the workspace that sent the document: its name, its colors (`primary_color` is the button background, `secondary_color` the button text, 6-digit hex without `#`) and the address of its logo, or `null` when it has none. The logo address carries no access code: append `signer-access-code` to it, as to every signer call. Available before verification and after the document is deleted, so every screen of the signing page can carry the brand. Uses the signer access code.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Fsign%2Ftheme) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fsign%252Ftheme%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fsign%252Ftheme%20and%20help%20me%20integrate%20this%20endpoint.)

## Response `200`

The brand

- object: Standard success wrapper. Operations add their own `data`.
  - `status` integer: HTTP status code, mirrored in the body.
  - `message` string: Human-readable message; empty on success.
  - `data` AccountTheme: An account's branding theme.
    - `account_name` string
    - `primary_color` string: Button background: hex color without leading `#`. The platform default when the account set none.
    - `secondary_color` string: Button text: hex color without leading `#`. The platform default when the account set none.
    - `logo` string, nullable: Absolute URL of the logo for the caller: `/v1/accounts/{accountId}/logo` for workspace members, `/v1/sign/logo` (append `signer-access-code`) for signers. `null` when the account has no logo.

## Other responses

- `400`: With a signer access code: the signer's step has not started yet (sequential signing).
- `401`: Missing or invalid credentials.
- `500`: Unexpected server error.

## Changes

> 20 revisions in range; 1 not diffed.

- **2026-11-11** `f4fa0790d9f8`: 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
- **2026-11-04** `5fcad067d962`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/assinafy/apis/assinafy-api-reference/changes/v1/sign/theme/get.md)

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/511261bfe294?raw)