Sending test assessment orders

API allows you to create test AssessmentOrders. These orders are fake and are not attached to any real customer, job or candidate. Adding fake assessment order happens through /assessments endpoint.

Note: Generated response is just a mock service and you are not able to perform actions on an order generated that way, e.g. accept / reject it, submit results etc.
In order to perform an end to end tests, please create a Test Offer, submit for activation to your test SmartRecruiters customer account and place an order for that offer from the customer account.

Submit a test assessment order

To submit test assessment order, you need to send POST request with body containing AssessmentOrder object:

curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/v1/assessments

body.json:

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
{
    "status": "NEW",
    "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"
    }
}

POST call above will result in AssessmentOrder object with unique id assigned to it. From now on, new AssessmentOrder can be used to attach results, comments and sending accept, reject or complete updates.

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
{
    "id": "517e897965320134375cb698",
    "status": "NEW",
    "createDate": "2013-04-29T14:53:45.904+0000",
    "lastUpdateDate": "2013-04-29T14:53:47.100+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": ""
    },
    "job": {
        "id": "e63dfcab300260b2591f585126ede56627db4321",
        "industry": {
            "id": "computer_software",
            "label": "Computer Software"
        },
        "function": {
            "id": "engineering",
            "label": "Engineering"
        },
        "experienceLevel": {
            "id": "mid_senior_level",
            "label": "senior"
        },
        "location": {
            "country": "US",
            "city": "Orlando"
        }
    },
    "company": {
        "id": "511a3942300469a9c33811d1",
        "name": "Orlando Magic Inc."
    },
    "offer": {
        "catalogId": "bbb-444-111",
        "name": "Senior Ruby Developer Skill Test"
    }
}