List assessment orders

In order to start evaluating the candidates, you might need to get a list of assessment orders. This task can be performed by using the GET request below

curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/v1/assessments?limit=20&offset=0&status=NEW

Response Body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
    "limit": 10,
    "offset": 0,
    "totalFound": 2,
    "content": [
        {
            "id": "511a3942300469a9c33819d8",
            "status": "NEW",
            "createDate": "2013-03-07T13:34:40.135+0000",
            "lastUpdateDate": "2013-03-07T13:34:40.135+0000",
            "requestor": {
                "firstName": "Rob",
                "lastName": "Kaman",
                "email": "rob.kaman@smartrecruiters.com",
                "phone": "(415) 111-2222"
            },
            "candidate": {
                "id": "e63dfcab300260b2591f585126ede56627db4ef8",
                "firstName": "Zoe",
                "lastName": "Temple",
                "email": "zoe.temple@smartrecruiters.com",
                "phone": "(415) 111-2222",
                "addressLine": "56 Tehama Street, San Francisco, CA 94105 "
            },
            "job": {
                "id": "e63dfcab300260b2591f585126ede56627db4321",
                "name": "Senior Java Developer",
                "industry": {
                    "id": "computer_software",
                    "label": "Computer Software"
                },
                "function": {
                    "id": "engineering",
                    "label": "Engineering"
                },
                "experienceLevel": {
                    "id": "mid_senior_level",
                    "label": "senior"
                },
                "location": {
                    "country": "US",
                    "region": "CA",
                    "city": "San Francisco"
                }
            },
            "company": {
                "id": "511a3942300469a9c3381ba3",
                "name": "Orlando Magic Inc."
            },
            "offer": {
                "catalogId": "aaa-123-bbb",
                "name": "Senior Java Developer Skill Test"
            }
        },
        {
            "id": "511a3942300469a9c33819d1",
            "status": "NEW",
            "createDate": "2013-03-07T13:34:40.137+0000",
            "lastUpdateDate": "2013-03-07T13:34:40.137+0000",
            "requestor": {
                "firstName": "Rob",
                "lastName": "Kaman",
                "email": "rob.kaman@smartrecruiters.com",
                "phone": "(415) 111-2222"
            },
            "candidate": {
                "id": "e63dfcab300260b2591f585126ede56627db4ef8",
                "firstName": "Mark",
                "lastName": "Hunt",
                "email": "mark.hunt@smartrecruiters.com",
                "phone": "(415) 111-2222",
                "addressLine": "409 North Magnolia Avenue, Orlando, FL 32801, United States "
            },
            "job": {
                "id": "e63dfcab300260b2591f585126ede56627db4321",
                "name": "Senior Ruby Developer",
                "industry": {
                    "id": "computer_software",
                    "label": "Computer Software"
                },
                "function": {
                    "id": "engineering",
                    "label": "Engineering"
                },
                "experienceLevel": {
                    "id": "mid_senior_level",
                    "label": "senior"
                },
                "location": {
                    "country": "US",
                    "region": "FL",
                    "city": "Orlando"
                }
            },
            "company": {
                "id": "511a3942300469a9c33811d1",
                "name": "Orlando Magic Inc."
            },
            "offer": {
                "catalogId": "bbb-444-111",
                "name": "Senior Ruby Developer Skill Test"
            }
        }
    ]
}

The response body will contain a ResultList object containing AssessmentOrder objects. This list can then be filtered by status and the date created. For more details on filtering and response and request settings, please check /assessments list method.

Note: Please do not use Company ID as a validation criteria. Use requestor’s email address instead.