Skip to main content
GET
curl

Overview

Returns the white-label branding for the application resolved from your API key — the same branding shown to end users in the verification flow. The response covers colors, fonts, border radii, logo URLs and UI/UX options.

When to use it

  • Read current theme — fetch the active palette, font and logos before rendering or editing them.
  • Sync branding — mirror Didit branding into your own admin UI.

Notes

  • The application is resolved from the API key — there are no path or query parameters.
  • logo_square, logo_rectangular, favicon and font_url are read-only. Set logos by uploading images in Update Branding.
  • Custom domain and white-label email are not part of this response; they remain managed in the Business Console.

Permissions

The API key must be able to read customization for the application.

Authorizations

x-api-key
string
header
required

Response

Current branding customization for the application.

White-label branding for an application: colors, fonts, radii, logo URLs and UI/UX options. Logo URLs are read-only (set them by uploading images). Custom domain and white-label email are not included.

color_primary
string
color_secondary
string
color_background
string
color_panel
string
color_panel_10
string
color_on_panel_1
string
color_on_panel_2
string
color_on_background
string
color_button_1
string
color_button_2
string
color_button_text_1
string
color_button_text_2
string
color_pill_text
string
border_radius_panel
integer
border_radius_buttons
integer
font_family
string
font_weight
string
font_url
string | null

Read-only. Resolved Google Fonts stylesheet URL for the selected family.

logo_square
string | null

Read-only URL of the square logo. Upload via image_square.

logo_rectangular
string | null

Read-only URL of the rectangular logo. Upload via image_rectangular.

favicon
string | null

Read-only URL of the favicon. Upload via image_favicon.

app_public_name
string | null
privacy_policy_url
string | null
skip_welcome_screen
boolean
disable_login_with_didit
boolean
hide_progress_bar
boolean
callback_seconds
integer