Retrieve certificate matching

Before creating a transaction, you may need to know if your participant has a valid certificate. The certificate has to be neither expired nor revoked.

To know if your participant has at least one valid certificate to perform an advanced signatre, send a request to POST /v1/certificates/match and pass the participant email.

curl \
-d \

You can set the following optional arguments:

  • mon_certificate_level: The minimum certificate level required for the match. Possible values are lcp (Lightweight Certificate Policy) and qcp (Qualified Certificate Policy).
  • fullname: the participant full name.
  • phone_number: the participant phone number.

The API returns a certificate object with true value if at least one valid certificate is matching all constraints provided as query parameters.

  "match_found": true

Identity prevalidation
About transaction templates
Developer tools
API reference