list

Description

Enables you to get a list of existing offers. The number of offers returned as part of the list can be modified using the offset and limit parameters. These results will be sorted using lastUpdateDate.

Request

GET https://api.smartrecruiters.com/v1/offers?limit={limit}&offset={offset}&status={offerStatus}&q={queryString}

Path Parameters

n/a

Query Parameters

name type description
limit integer number of offers to return. max number of offers returned by single call is 100
offset integer number of offers to skip while processing result
status string offer status. legal values are: INACTIVE, UNDER_REVIEW, ACTIVE, REJECTED
q string full text query. will match offers with name and description matching query string

Request Body

n/a

Response Body

ListResult containing list of Offers

Example request

curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/v1/offers?limit=10&offset=10&q=java

Example response

{
    "offset": 0,
    "limit": 10,
    "totalFound": 3,
    "content": [
        {
            "id": "511a3942300469a9c33819d8",
            "createDate": "2013-03-13T12:05:46.398+0000",
            "lastUpdateDate": "2013-03-13T12:05:46.398+0000",
            "catalogId": "ab-32-gf-asd",
            "name": "Java Developer Skill Test",
            "description": "Senior Java Developer Test",
            "status": "ACTIVE",
            "terms": {
                "type": "SKILLS_TEST",
                "price": {
                    "amount": "20.00",
                    "currencyCode": "USD"
                }
            }
        },
        {
            "id": "432a3942abc469a9c33819d8",
            "createDate": "2013-03-13T12:05:46.398+0000",
            "lastUpdateDate": "2013-03-13T12:05:46.398+0000",
            "catalogId": "df-55-gf-123",
            "name": "Java Architect Test",
            "description": "Java Architect Skill Test",
            "status": "ACTIVE",
            "terms": {
                "type": "SKILLS_TEST",
                "price": {
                    "value": "60.00",
                    "currencyCode": "USD"
                }
            }
        },
        {
            "id": "432a3942abc469a32c33549d8",
            "createDate": "2013-03-13T12:05:46.398+0000",
            "lastUpdateDate": "2013-03-13T12:05:46.398+0000",
            "catalogId": "df-55-12-bbb",
            "name": "Enterprise Java Beans Test",
            "description": "Enterprise Java Beans Test",
            "status": "UNDER_REVIEW",
            "terms": {
                "type": "SKILLS_TEST",
                "price": {
                    "amount": "40.00",
                    "currencyCode": "USD"
                }
            }
        } 
    ]
}