Skip to main content
Version: 2.0

YesWeCheck API

YesWeCheck public API: email address verification, input assistance and enrichment.

Base URL: https://api.yeswecheck.fr. API routes are prefixed with /v2; only /health is served outside the prefix.

Authentication: Authorization: Bearer ywc_live_… (or ywc_test_…, same behaviour). The X-API-Key header is not read.

SMTP: with an API key, the key's configuration decides whether the SMTP check runs. The smtp field in the body is ignored.

Credits: 1 credit is debited per verification where SMTP was enabled and the final verdict is not unknown. All other endpoints are free.

Errors: the message is in French by default; send Accept-Language: en (or en-GB) to receive it in English. Always test the code, never the message.

This specification only covers routes reachable with an API key or without authentication. Batch processing and the management of keys, widgets and billing are handled from the dashboard at https://app.yeswecheck.fr/uk.

Authentication​

API key created in the dashboard (API keys): Authorization: Bearer ywc_live_….

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

ywc_live_…

Contact

YesWeCheck Support: [email protected]

URL: https://docs.yeswecheck.fr/uk