Contact the Certn Partnerships Team

To request a demo account, email Certn's Partnership Team at [email protected]. They will arrange a call to learn about your organization's specific requirements and to help you set up your demo account.

Once created, you will be invited into your demo account via email, and prompted to create a password.

Set up your account for API tests

Set up your account on our dashboard to start testing our API.

1. Go to

2. Enter your email and password

3. Click Log in

Add a payment card

Adding a payment card to your account allows you to test a greater variety of features. Since this is a demo environment, you can use the card information provided below.

From your team's Settings page:

1. Click Billing

2. Click Connect Payment Card

3. Fill in the following card number: 4242 4242 4242 4242

Create an API key

1. Navigate back to the dashboard by clicking the Certn logo in the top left

2. Click on the Partner tab

3. Click Refresh Keys

You can now start testing the API with your demo account.

Get production access

When you’re ready to use the API in production, send us an email at .

You'll need to know how to before you can follow the instructions in this section.

Organizational structure

When you're set up within Certn, you belong to an organization. This organization has a few levels of hierarchy:

To follow this guide, you need a demo account. Make sure it's fully set up according to our instructions on how to request a demo account.

Send a request

‌To communicate with our API, you'll need to build HTTP requests. You can use the programming language of your choice to achieve this. We provide examples of scripts using Python, but most of the content you'll work with will be in JSON.‌

Get your API access token

‌To gain access to our API, you will need your Client ID and Client Secret. Instructions for getting these values can be found in . You should take special precautions to keep your client secret a secret. In the example below (using our demo environment https://demo-api.certn.co), we show you how you can use secrets stored in a .env file.

First, make a request to get your access token. This token will be required to make all other API requests. For this step, make a GET request to our /token/ endpoint. If you're new to HTTP requests, visit for useful guides.

With everything set properly and a good internet connection, you should receive a response.status_code of 200 OK. The response.data object should look something like:

You'll need this access_token as a bearer token in headers for all requests to our API. Let's see how to use this to .

Errors

Please see and for more details on types of errors, and how to resolve them.

You'll need to know how to create an application before you can follow the instructions in this section.

Request

The results you got from the Softcheck quickscreen creation call indicate that we received your request and are actively working on it. You can see this by checking the report_status field, which will likely be ANALYZING. These results will not be updated in real-time. To retrieve the updated versions, you can set up a webhook, or send requests to one of our endpoints.

Choose your endpoint

In this guide, we'll show you how to send requests to our API to retrieve the status of your application via our endpoints. When using this method, keep sending requests until the field report_status is marked as COMPLETE. Then, you can view your final report.

We'll use the /applicants endpoint, which allows you to retrieve the report as a JSON object.

Get your application ID

To tell the API which application to retrieve, you need to provide it with the right application ID. You'll find it in the response of the creation call, under id. We use , so it'll be formatted like this:123e4567-e89b-12d3-a456-426614174000

Set up your URL

Once you have your application ID, append it to /applicants URL.

1. Choose the URL that corresponds to your industry

2. In the URL, replace {application_id} with your application's ID

Send the request

Now we're ready to bring it all together. Our /applicants endpoint accepts GET requests, so make sure that is what you use.

Here is what your full script may look like when using Python:

In the previous example, we saved the results of the call to a new file named results_softcheck_demo.json.‌

With everything set properly and a good internet connection, you should receive a response status of 200 OK.

Errors

Please see for more details on types of errors, and how to resolve them.

You'll need to know to follow the instructions in this page.

Get the URL

‌You can find the URLs for all our endpoints in the section of this documentation. Knowing how to use them can be helpful, so we'll show you how they're created.‌

In this example, you'll be making calls to our demo environment, https://demo-api.certn.co