Submit / Withdraw Offer

🛑

Assessment API Sunset

This API has been deprecated since September 4, 2023. The sunset date is May 10, 2024. If you are an assessment provider or looking to build an assessment integration with SmartRecruiters, please consider using the new Assessment API (2021).

Offer statuses

An offer can be in one of these 4 statuses: INACTIVE, UNDER_REVIEW, ACTIVE and REJECTED. The ‘offer’ object contains the “status” field indicating its current offer status. This status is retrieved in every GET call for the Offer object.

Here is a brief description about each offer status:

  • INACTIVE – An offer takes the INACTIVE status immediately after its creation. An INACTIVE status means that the offer is not yet available in the marketplace and needs to be submitted for review and activation.
  • UNDER_REVIEW – An offer takes this status on being submitted for review. The offer remains in this status until it is either accepted or rejected by a marketplace administrator.
  • ACTIVE – An ACTIVE status means that the offer was accepted by a marketplace administrator and is available in the marketplace for customers to buy.
  • REJECTED – The offer was rejected by the marketplace administrator and needs to be updated and resubmitted for further review before entering the marketplace.

Submit an Offer

After an offer is successfully created, it needs to be submitted for review. The submission process is easy and can be performed using the following POST Request:

curl -i
     -H "X-SmartToken:abc123"
     -H "Content-Type: application/json;charset=utf-8"
     -X POST
     https://api.smartrecruiters.com/v1/offers/511a3942300469a9c33819d8/submit

Withdraw an Offer

You can withdraw an offer from the marketplace at any point in time. Such an offer needs to be resubmitted before it is available again in the marketplace. Offer withdrawal can be performed using the following POST request:

curl -i
     -H "X-SmartToken:abc123"
     -H "Content-Type: application/json;charset=utf-8"
     -X POST
     https://api.smartrecruiters.com/v1/offers/511a3942300469a9c33819d8/withdraw