Get existing contract details

Offer Details

As part of your integration, you might want to support SmartRecruiters customers’ existing contracts with your Job Board.

In order to do it, use a Posting ID you can get in the Get job postings step.
With this Posting ID, you can get Offer details which contain existing contract information as shown on the below example:

curl -i -H "X-SmartToken: 123456" -X GET https://api.smartrecruiters.com/v1/offers?postingId=107099725

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
{
    "limit": 100,
    "offset": 0,
    "totalFound": 1,
    "content": [
        {
            "id": "44339b55e4b00655426eb029",
            "createDate": "2015-08-18T20:53:41.420+0000",
            "lastUpdateDate": "2015-08-18T21:19:37.033+0000",
            "name": "30 Day Job Posting",
            "description": "This is an example offer description that is visible in the SmartRecruiters Marketplace",
            "terms": {
                "price": {
                    "amount": 150,
                    "currencyCode": "USD"
                },
                "postingPeriod": 30,
                "existingContract": {
                      "password": "pass",
                      "login": "login"
                }
            },
            "status": "ACTIVE",
            "targetMarket": {
                "industries": [],
                "functions": [],
                "experienceLevels": [],
                "locations": [
                    {
                        "country": "United States"
                    }
                ]
            },
            "availability": {
                "industries": [],
                "locations": [
                    {
                        "country": "United States"
                    }
                ],
                "companies": [
                    "SmartRecr",
                    "Donnie Company ABC"
                ]
            }
        }
    ]
}

Note: For this endpoint please use the same API Token you have used for getting postings.

Fields in existingContract node in the above example are responsible for exposing the existing contract information. Please use them to link it to your existing customer.