> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer le branding via l'API de personnalisation

> Lisez le branding en marque blanche de votre application via l'API de gestion Didit : couleurs, polices, rayons, logos et options d'interface.



Prompt pour obtenir l'identité visuelle
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\`Goal: Read the white-label branding for the application tied to an API key.

Endpoint: GET https://verification.didit.me/v3/customization/
Auth header: x-api-key: <DIDIT_API_KEY>

No path or query params. The application is resolved from the API key.

Response 200: a BrandingCustomization object:
\- Colors: color_primary, color_secondary, color_background, color_panel, color_panel_10, color_on_panel_1, color_on_panel_2, color_on_background, color_button_1, color_button_2, color_button_text_1, color_button_text_2, color_pill_text (hex strings)
\- border_radius_panel, border_radius_buttons (integers)
\- font_family, font_weight, font_url (font_url is read-only)
\- logo_square, logo_rectangular, logo_rectangular_dark, favicon (read-only URLs; null when unset)
\- logo_rectangular_dark: the rectangular logo for dark mode; null when no dark logo is set or rectangular logos are not shown for your account
\- app_public_name, privacy_policy_url, skip_welcome_screen, disable_login_with_didit, hide_progress_bar, callback_seconds

Not included: custom domain and white-label email settings (Business Console only).

curl:
curl -X GET 'https://verification.didit.me/v3/customization/' \
-H 'x-api-key: YOUR_API_KEY'

Failure modes:
\- 401 — missing/invalid x-api-key.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\</pre>



      
      

Coller dans

## Vue d'ensembleRenvoie l'identité visuelle en marque blanche de l'application identifiée par votre clé API, soit la même identité visuelle que celle affichée aux utilisateurs finaux dans le [parcours de vérification](https://docs.didit.me/fr/console/white-label.md). La réponse couvre les couleurs, les polices, les rayons de bordure, les URL des logos et les options d'interface utilisateur et d'expérience utilisateur.## Quand l'utiliser- **Lire le thème actuel** : récupérer la palette, la police et les logos actifs avant de les afficher ou de les modifier.
- **Synchroniser l'identité visuelle** : reproduire l'identité visuelle de Didit dans votre propre interface d'administration.## Notes- L'application est identifiée à partir de la clé API : il n'existe aucun paramètre de chemin ni de requête.
- `logo_square`, `logo_rectangular`, `logo_rectangular_dark`, `favicon` et `font_url` sont en lecture seule. Pour définir les logos, téléversez des images dans [Mettre à jour l'identité visuelle](https://docs.didit.me/fr/management-api/customization/update.md).
- `logo_rectangular_dark` est le logo rectangulaire pour le mode sombre, affiché sur un fond sombre.
  Il vaut `null` lorsqu'aucun logo sombre n'est défini ou lorsque les logos rectangulaires ne sont pas affichés pour votre compte.
- Le domaine personnalisé et l'e-mail en marque blanche ne font **pas** partie de cette réponse ; ils restent gérés dans la Business Console.## AutorisationsLa clé API doit pouvoir lire la personnalisation de l'application.## Voir aussi- [Mettre à jour l'identité visuelle](https://docs.didit.me/fr/management-api/customization/update.md)
- [Marque blanche dans la Console](https://docs.didit.me/fr/console/white-label.md)


## OpenAPI

````yaml fr/openapi-25.json GET /v3/customization/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/customization/:
    get:
      tags:
        - Customization
      summary: Obtenir la personnalisation de marque
      description: >-
        Renvoie la personnalisation en marque blanche pour l'application résolue
        à partir de la clé API : couleurs, polices, rayons de bordure, URL de
        logos et options d'UI/UX. Les paramètres de domaine personnalisé et
        d'e-mail en marque blanche sont gérés uniquement dans la Business
        Console et ne font pas partie de cette réponse.
      operationId: get_customization
      responses:
        '200':
          description: Personnalisation actuelle de l'image de marque pour l'application.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandingCustomization'
              examples:
                Default branding:
                  value:
                    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
                    logo_square: null
                    logo_rectangular: null
                    logo_rectangular_dark: 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
        '403':
          description: >-
            Clé API manquante, mal formée, expirée ou limitée à une application
            différente. Une clé manquante renvoie `403` ; une clé erronée,
            révoquée ou expirée renvoie `401`.
          content:
            application/json:
              examples:
                Invalid token:
                  value:
                    detail: You do not have permission to perform this action.
        '429':
          description: >-
            Limite de débit dépassée. Réessayez avec une temporisation
            exponentielle.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: |-
            curl -X GET 'https://verification.didit.me/v3/customization/' \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.customization.retrieve()
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            const result = await didit.customization.retrieve();
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Customization.Retrieve(ctx)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            var result = client.customization().retrieve();
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            $result = $didit->customization->retrieve();
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.customization.retrieve
            puts result.to_h
        - lang: csharp
          label: .NET
          source: |-
            using System;
            using System.Text.Json;
            using Didit;

            // Reads DIDIT_API_KEY.
            using var client = new DiditClient();

            var result = await client.Customization.RetrieveAsync();
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    BrandingCustomization:
      type: object
      description: >-
        Personnalisation en marque blanche pour une application : couleurs,
        polices, arrondis, URL des logos et options UI/UX. Les URL des logos
        sont en lecture seule (définissez-les en téléversant des images). Le
        domaine personnalisé et l'e-mail en marque blanche ne sont pas inclus.
      properties:
        color_primary:
          type: string
        color_secondary:
          type: string
        color_background:
          type: string
        color_panel:
          type: string
        color_panel_10:
          type: string
        color_on_panel_1:
          type: string
        color_on_panel_2:
          type: string
        color_on_background:
          type: string
        color_button_1:
          type: string
        color_button_2:
          type: string
        color_button_text_1:
          type: string
        color_button_text_2:
          type: string
        color_pill_text:
          type: string
        border_radius_panel:
          type: integer
        border_radius_buttons:
          type: integer
        font_family:
          type: string
        font_weight:
          type: string
        font_url:
          type: string
          nullable: true
          description: >-
            Lecture seule. URL résolue de la feuille de style Google Fonts pour
            la famille sélectionnée.
        logo_square:
          type: string
          nullable: true
          description: URL en lecture seule du logo carré. Téléversez via `image_square`.
        logo_rectangular:
          type: string
          nullable: true
          description: >-
            URL en lecture seule du logo rectangulaire. Téléversez via
            `image_rectangular`.
        logo_rectangular_dark:
          type: string
          format: uri
          nullable: true
          description: >-
            Lecture seule. URL signée temporaire du logo rectangulaire pour le
            mode sombre, affiché sur fond sombre. Vaut `null` lorsqu'aucun logo
            sombre n'est configuré ou que les logos rectangulaires ne sont pas
            affichés pour votre compte. Téléversez-le avec
            `image_rectangular_dark`.
        favicon:
          type: string
          nullable: true
          description: URL en lecture seule du favicon. Téléversez via `image_favicon`.
        app_public_name:
          type: string
          nullable: true
        privacy_policy_url:
          type: string
          nullable: true
        skip_welcome_screen:
          type: boolean
        disable_login_with_didit:
          type: boolean
        hide_progress_bar:
          type: boolean
        callback_seconds:
          type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clé API de votre application, issue de Développeurs -> Clés API dans
        la Business Console. La clé principale dispose d'un accès complet. Une
        clé nommée peut être restreinte : aucun, lecture ou écriture par
        ressource, limitée à certains workflows ou aux sessions approuvées, à
        une liste d'adresses IP et à une date d'expiration. 401 signifie que la
        clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a
        été envoyée, que la clé n'a pas accès à cette ressource ou action, ou
        que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur
        une route de session signifie que la session est hors des workflows ou
        des statuts de la clé. Une clé sans accès aux médias reçoit les URL
        d'images, de vidéos et de PDF à null, et une clé sans accès en écriture
        aux sessions reçoit les liens et tokens de session à null. Voir
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.