---
updatedAt: 2026-05-21T16:40:27.000Z
---

# Récupérer un fournisseur de consentement spécifique

Utilisez cette API pour récupérer un fournisseur de consentement existant. <br/><br/><b>Entitlements requis (l'un des suivants):</b> <ul><li>readPrivacyConsentProvider (Lire les fournisseurs de consentement à la protection de la vie privée)</li> <li>managePrivacyConsentProvider (Gérer les fournisseurs de consentement à la protection de la vie privée)</li></ul>

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "Data privacy & consent",
    "title": "Data privacy & consent"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Data Privacy and Consent Management"
    }
  ],
  "paths": {
    "/config/v1.0/privacy/consent-providers/{id}": {
      "get": {
        "tags": [
          "Data Privacy and Consent Management"
        ],
        "summary": "Récupérer un fournisseur de consentement spécifique",
        "description": "Utilisez cette API pour récupérer un fournisseur de consentement existant. <br/><br/><b>Entitlements requis (l'un des suivants):</b> <ul><li>readPrivacyConsentProvider (Lire les fournisseurs de consentement à la protection de la vie privée)</li> <li>managePrivacyConsentProvider (Gérer les fournisseurs de consentement à la protection de la vie privée)</li></ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identifiant du fournisseur de consentement",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Données de configuration du fournisseur de consentement",
            "content": {
              "*/*": {
                "schema": {
                  "title": "ConsentProvider",
                  "required": [
                    "integrationId",
                    "name",
                    "type"
                  ],
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Identifiant du fournisseur de consentement. Ce champ est obligatoire, il accepte les caractères alphanumériques et -,_."
                    },
                    "name": {
                      "maxLength": 256,
                      "type": "string",
                      "description": "Nom du fournisseur de consentement. Cette zone est requise."
                    },
                    "description": {
                      "maxLength": 256,
                      "type": "string",
                      "description": "Description du fournisseur de consentement. Cette zone est requise."
                    },
                    "type": {
                      "maxLength": 256,
                      "type": "string",
                      "description": "Type d'intégration. Cette zone est requise.",
                      "enum": [
                        "webhook"
                      ]
                    },
                    "integrationId": {
                      "type": "string",
                      "description": "Si le type d'intégration est un webhook, il s'agit de l'identifiant du webhook. Ce champ est obligatoire, il accepte les caractères alphanumériques et -,_."
                    },
                    "referenceId": {
                      "type": "string",
                      "description": "Identifiant de référence du webhook. Ce champ est obligatoire si le type d'intégration est webhook, il accepte les caractères alphanumériques et -,_."
                    },
                    "profile": {
                      "type": "object",
                      "properties": {
                        "restrictScopes": {
                          "type": "boolean",
                          "description": "Un drapeau booléen indiquant s'il faut restreindre les champs d'application.",
                          "default": true
                        },
                        "scopes": {
                          "type": "array",
                          "description": "Scopes sous la forme d'un tableau de chaînes de caractères.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          }
                        },
                        "restrictPurposes": {
                          "type": "boolean",
                          "description": "Un drapeau booléen indiquant s'il faut restreindre les objectifs.",
                          "default": true
                        },
                        "purposes": {
                          "type": "array",
                          "description": "Objectifs sous la forme d'un tableau de chaînes de caractères.",
                          "items": {
                            "maxLength": 64,
                            "type": "string"
                          }
                        },
                        "subjectMapping": {
                          "type": "object",
                          "properties": {
                            "attributeId": {
                              "type": "string",
                              "description": "Un attribut défini sur le locataire."
                            },
                            "transform": {
                              "type": "string",
                              "description": "Une simple transformation de fonction, telle que la majuscule. La liste complète peut être obtenue en invoquant https://tenant_hostname/v1.0/attributefunctions."
                            },
                            "rule": {
                              "type": "string",
                              "description": "Une expression de règle avancée suivant la syntaxe documentée dans https://www.ibm.com/docs/en/security-verify?topic=attributes-attribute-functions."
                            }
                          }
                        }
                      }
                    },
                    "batchSize": {
                      "type": "object",
                      "properties": {
                        "dua": {
                          "type": "integer",
                          "description": "Lorsqu'elle est définie à une valeur non nulle, cette valeur sera utilisée lors de l'exécution pour diviser les éléments de consentement."
                        },
                        "dsp": {
                          "type": "integer",
                          "description": "Lorsqu'elle est définie à une valeur non nulle, cette valeur sera utilisée lors de l'exécution pour diviser les éléments de consentement."
                        },
                        "consents": {
                          "type": "integer",
                          "description": "Lorsqu'elle est définie à une valeur non nulle, cette valeur sera utilisée lors de l'exécution pour diviser les éléments de consentement."
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "createdTime": {
                          "type": "string",
                          "description": "Un horodatage (UTC) indiquant l'heure de création du fournisseur de consentement.",
                          "format": "date-time"
                        },
                        "lastModifiedTime": {
                          "type": "string",
                          "description": "Un horodatage (UTC) indiquant l'heure de modification du fournisseur de consentement.",
                          "format": "date-time"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "La ressource demandée n'existe pas.",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/Error404"
                }
              }
            }
          },
          "500": {
            "description": "Une erreur interne du serveur s'est produite.",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/Error500"
                }
              }
            }
          }
        },
        "x-publicAPI": "true",
        "x-category": "Data privacy & consent"
      }
    }
  },
  "components": {
    "schemas": {
      "Error404": {
        "required": [
          "messageDescription",
          "messageId"
        ],
        "type": "object",
        "properties": {
          "messageId": {
            "type": "string",
            "description": "L'identifiant de la clé de message",
            "example": "CSIBTXXXXE"
          },
          "messageDescription": {
            "type": "string",
            "description": "Un message descriptif spécifique à la locale du demandeur",
            "example": "String message"
          }
        }
      },
      "Error500": {
        "required": [
          "messageDescription",
          "messageId"
        ],
        "type": "object",
        "properties": {
          "messageId": {
            "type": "string",
            "description": "L'identifiant de la clé de message",
            "example": "CSIBTXXXXE"
          },
          "messageDescription": {
            "type": "string",
            "description": "Un message descriptif spécifique à la locale du demandeur",
            "example": "String message"
          }
        }
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```