Quickstart

1. Get an API key

Sign up at the Cerrtify dashboard and provision an API key for the sandbox environment. Keys look like cert_<prefix>_<secret> and are environment-scoped — sandbox keys cannot call production and vice versa.

2. Pick a base URL

The switcher in the top-right controls which environment the snippets on this page point to:

• Sandbox → https://sandbox-api.cerrtify.com
• Production → https://api.cerrtify.com

Currently selected: https://sandbox-api.cerrtify.com

3. Start a BankID auth order

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/auth \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"endUserIp":"192.168.0.1"}'

You'll get back an orderRef, plus autoStartToken, qrStartToken, and qrStartSecret for QR rendering.

4. Poll until done

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/collect \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"orderRef":"<from-step-3>"}'

Poll every ~2 seconds until status is complete or failed. The full flow (with QR rendering and cancel) is covered in the BankID auth guide.

Next steps

• Read Authentication for key rotation, scopes, and CORS.
• Browse the API Reference.
• Try the Company lookup guide or the Persondata search guide.