Prerequisites

To use the CertiDrive API, you must:

• Have an active CertiDrive account (your organization must be onboarded and enabled in CertiDrive).

• Be approved by Transportstyrelsen for the relevant services and usage required for your integration.

• Have a valid API key generated in the CertiDrive Control Panel.

If you are missing any of the above, API access will be denied.

Authentication

All API requests must be authenticated using an API key issued from the CertiDrive Control Panel.

You can send the key in either of these headers:

• Authorization: Bearer <API_KEY>

• x-api-key: <API_KEY>

Keep your API keys secret. Do not embed them in client-side apps or publish them in public repositories.

Base URL

All endpoints are served from:

• https://api.certidrive.se

Quick Start Example

curl -X GET "https://api.certidrive.se/v1/registrations?limit=20"
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"

API Keys

API keys are managed in the CertiDrive Control Panel:

• Create one key per integration/system (recommended)

• Assign the appropriate permissions/scopes (if enabled)

• Rotate keys regularly and revoke keys you no longer need

Errors

The API uses standard HTTP status codes:

• 401 Unauthorized – missing or invalid API key

• 403 Forbidden – account not enabled, missing permissions, or Transportstyrelsen approval not valid for the requested operation

• 422 Unprocessable Entity – validation error

• 429 Too Many Requests – rate limit exceeded (if enabled)

• 5xx – server error

What’s Next?

• Create an API key in the CertiDrive Control Panel

• Try your first request using the Quick Start Example

• Explore the full endpoint reference in the API Documentation (OpenAPI/Swagger)

If you need Transportstyrelsen enablement or onboarding support, contact your CertiDrive administrator or support channel.