Getting Started

Getting Started


Step 1: Decide how you will access the APIs

Before you begin, decide whether you are accessing the APIs as an individual or on behalf of a company.


  • Individual developers typically use a Single Sign On (SSO) account
  • Organizations and system integrations typically use a B2B (company) account managed through Veracity Access Hub

This decision affects how users, permissions, and access tokens are managed. More details are available in the FAQ section on account types.

Step 2: Create your account

Create an SSO account

If you are an individual user, create an SSO account through the Veracity sign up page. This account represents you personally and gives access to Veracity services and APIs based on your subscriptions and permissions.

Create or join a B2B account

If you are working on behalf of a company, your organization must have a B2B account in Veracity Access Hub.


Company administrators manage users, roles, and application access centrally.

Before API access can be granted, the Legal Terms and Conditions must be completed and signed.


On the Legal Terms and Conditions tab, you are required to provide the following information:

  • Name
  • Email address
  • Company
  • Project
  • Description of your API needs

Once the Legal Terms and Conditions have been submitted and signed, the request is reviewed by DNV.


When the terms have been approved, you will receive a confirmation email from ProjectConnect@dnv.com confirming when access to the specified project has been opened.


Only after this confirmation is received will the project data available through the API.

Step 4: Authenticate and obtain an access token

DNV APIs use OAuth 2.0 and OpenID Connect for authentication.


After signing in, Veracity issues security tokens that allow you to call APIs securely. The key token for API access is the Access Token (JWT).



In short:

  1. Authenticate using OAuth 2.0 / OIDC
  2. Receive an Access Token (JWT)
  3. Include the token in each API request

The access token proves who you are and what you are allowed to do.

Step 5: Call the APIs

Once you have an access token, you can start calling DNV APIs.


Each API request must:

  • Include the Access Token in the Authorization header
  • Use the scopes and permissions granted to your user or company
  • Follow the API specific documentation for endpoints and payloads

If the token is expired, use the refresh flow to obtain a new one.