list

Description

Enables you to get a list of assessment order IDs

Request

GET https://api.smartrecruiters.com/v1/assessments?limit={limit}&offset={offset}&status={offerStatus}&fromDate={fromDate}&toDate={toDate}

Path Parameters

n/a

Query Parameters

name type description
limit integer number of orders to return. max value is 100
offset integer number of orders to skip while processing result
status string order status filter. Legal values are: NEW, IN_PROGRESS, REJECTED, COMPLETED. List operation will return only matching offers
fromDate string createDate filter. search will return only orders created after given date. Date format need to comply with description here: Date
toDate string createDate filter. search will return only orders created before given date. Date format need to comply with description here: Date

Request Body

n/a

Response Body

ListResult containing list of AssessmentOrders

Example request

curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/v1/assessments?limit=10&offset=10&fromDate=2013-01-16&toDate=2013-02-22&status=NEW

Example response

{
    "limit": 10,
    "offset": 0,
    "totalFound": 2,
    "content": [
        {
            "id": "511a3942300469a9c33819d8",
            "status": "NEW",
            "createDate": "2013-01-23T13:34:40.135+0000",
            "lastUpdateDate": "2013-03-23T13:34:40.135+0000",
            "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": "e45dfcab300260b2591f585126ede56627db4ef8",
                "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": "511a3942300469a9c33811d1",
                "name": "Oracle Inc."
            },
            "offer": {
                "catalogId": "aaa-123-bbb",
                "name": "Senior Java Developer Skill Test"
            }
        },
        {
            "id": "511a3942300469a9c33819d1",
            "status": "NEW",
            "createDate": "2013-01-25T13:34:40.137+0000",
            "lastUpdateDate": "2013-01-25T13:34:40.137+0000",
            "candidate": {
                "id": "e44dfcab300260b2591f585126ede56627db4ef8",
                "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": "e63dfcab377260b2591f585126ede56627db4ef8",
                "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": "322a3942300469a9c33811d1",
                "name": "Orlando Magic Inc."
            },
            "offer": {
                "catalogId": "bbb-444-111",
                "name": "Senior Ruby Developer Skill Test"
            }
        }
    ]
}