Retrieve the results

You'll need to know how to send a request before you can follow the instructions in this section.
Request
The results you got from the Softcheck quickscreen indicate that we have received your request and are actively working on it. You can see this by checking the report_status field, which will likely be marked as 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 our /applicants endpoint.
You can view the final report when the field report_status is marked as COMPLETE.
Choose your endpoint
For this example, we'll use the /applicants endpoint, which allows you to retrieve the report as a JSON object.
You can also download reports as PDF or HTML files via our /reports endpoint.
Get your application ID
To tell the API which application to send back, 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 universally unique identifiers (UUIDs)​
, so it'll be formatted like this:123e4567-e89b-12d3-a456-426614174000
Setup your URL
Once you have your application ID, append it to the URL.
1.Choose the URL that corresponds to your industry
2.In the URL, replace <applicationID> with your application's ID
Human Resources
Property Management
1
"https://demo-api.certn.co/hr/v1/applicants/<applicationID>"
Copied!
1
"https://demo-api.certn.co/api/v2/applicants/<applicationID>"
Copied!
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:
Python
1
import requests
2
import json
3
​
4
############### Optional ###############
5
​
6
# Gets the application ID from the previous request
7
with open("softcheckDemo.json") as f:
8
  softcheckResponse = json.load(f)
9
  
10
applicationID = softcheckResponse['id']
11
​
12
############# End Optional ##############
13
​
14
​
15
### Replace <token> with your API Key
16
headers = { "Authorization": "Bearer <token>" }
17
​
18
### Replace <URL> with the URL that corresponds to your industry and
19
### append the application ID
20
url = "<URL>"
21
​
22
# Sends the HTTP request to the API via GET
23
result = requests.get(url, headers=headers)
24
​
25
​
26
############### Optional ###############
27
​
28
# Brings errors to the forefront
29
response.raise_for_status()
30
​
31
# Writes the contents of the report to a file 
32
# named "resultsSoftcheckDemo.json"
33
with open("resultsSoftcheckDemo.json", "w") as f:
34
    f.write(result.text)
35
  
36
############# End Optional ##############
Copied!
In the previous example, we saved the results of the call to a new file named resultsSoftcheckDemo.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
Here are some errors you may encounter when doing this exercise, and how to fix them.‌
401 Unauthorized
Find this error in the previous article.
403 Forbidden
Find this error in the previous article.
404 Not found
You may receive a 404 Not found if:‌
The application ID couldn't be found
"detail": "Not found."
The application ID is a string of letters
<HTML Page> NOT FOUND
How to fix this issue
Append your application ID to the end of the URL and make sure it is in the proper format.
Error codes

Send your first request

Next - Guides

Manage your team

Last modified 14d ago

Export as PDF

Copy link

Contents

Request

Choose your endpoint

Get your application ID