Skip to main content
GET
/
v3
/
customization
curl
curl -X GET 'https://verification.didit.me/v3/customization/' \
  -H 'x-api-key: YOUR_API_KEY'
{
  "color_primary": "#000000",
  "color_secondary": "#9DA1A1",
  "color_background": "#FFFFFF",
  "color_panel": "#2567FF",
  "color_panel_10": "#1A1A1A",
  "color_on_panel_1": "#9DA1A1",
  "color_on_panel_2": "#F4F4F6",
  "color_on_background": "#000000",
  "color_button_1": "#2567FF",
  "color_button_2": "#F8F8F8",
  "color_button_text_1": "#FFFFFF",
  "color_button_text_2": "#000000",
  "color_pill_text": "#111827",
  "border_radius_panel": 10,
  "border_radius_buttons": 12,
  "font_family": "Inter",
  "font_weight": "regular",
  "font_url": "https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap",
  "logo_square": null,
  "logo_rectangular": null,
  "favicon": null,
  "app_public_name": "Acme Verify",
  "privacy_policy_url": "https://acme.com/privacy",
  "skip_welcome_screen": false,
  "disable_login_with_didit": false,
  "hide_progress_bar": false,
  "callback_seconds": 3
}

​
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