LogoLogo
Sign InCertnCertn Help
Certn API
Certn API
  • Certn API
  • Getting Started
    • Request a demo account
      • Get your access token
      • Understand your general resources
      • Create your first application
      • Retrieve the results
  • Guides
    • Manage your settings
    • Manage your integration users
    • Use the API
      • Get and use an Authorization Token
      • Use webhooks
        • Webhook parameters and example
      • Get the applicant's consent
    • Run a check
      • Address Reference Check
      • Australia Right To Work Check
      • Basic Disclosure And Barring Service Check
      • Basic Disclosure Scotland Check
      • Canadian Criminal Record Check
      • Credential Verification
      • Credit Check
      • Education Verification
      • Employment Verification
      • Employment Reference Check
      • Enhanced Identity Verification
      • International Criminal Record Check
      • Motor Vehicle Record Check / Driver's Abstract
      • Softcheck
      • Social Media Check
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • Settings and packages
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
        • Package settings
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook

The Certn Group of companies includes Certn, Credence & InterCheck. For educational purposes, these companies are referred to as “Certn” in this website. For questions about any of the aforementioned companies, contact support@certn.co. ©2023 Certn.

On this page
  • Request
  • Choose your endpoint
  • Get your application ID
  • Set up your URL
  • Send the request
  • Errors

Was this helpful?

Export as PDF
  1. Getting Started
  2. Request a demo account

Retrieve the results

PreviousCreate your first applicationNextManage your settings

Last updated 1 year ago

Was this helpful?

You'll need to know how to 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 , 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.

Once your report is ready, you can download it as a PDF or HTML file via our /reports endpoint.

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

applicant_url = f"https://demo-api.certn.co/api/v1/hr/applicants/{application_id}/"
applicant_url = f"https://demo-api.certn.co/api/v1/pm/applicants/{application_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:

import requests
import json

############### Optional ###############

# Gets the application ID from the previous request
with open("softcheck_demo.json") as f:
  softcheck_response = json.load(f)
  
application_id = softcheck_response.get('id')

############# End Optional ##############

# Use your access token in the header.
headers = { "Authorization": f"Bearer {access_token}" }

# URL to retrieve the applicant details, determined by your industry
url = applicant_url

# Send the HTTP request to the API via GET
result = requests.get(url, headers=headers)

############### Optional ###############

# Brings errors to the forefront
result.raise_for_status()

# Writes the contents of the report to a file 
# named "results_softcheck_demo.json"
with open("results_softcheck_demo.json", "w") as f:
    f.write(result.text)
  
############# End Optional ##############

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.

200 OK

[...] "id": "<number>" [...] "report_status": "COMPLETE" [...]

Errors

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

Error codes
create an application
webhook
universally unique identifiers (UUIDs)