Position Schema

The position object:

FieldTypeDescription
uidstringPosition UID
namestring
statusstringOne of the following:
open
on hold
closed
is_discreetbooleantrue means that the position is only visible to teammates on the position's hiring team.
is_publishedbooleantrue means that the position is published on the company's website.
internal_namestring
departmentstring
emailstringPosition’s email – candidates can send resume to this email address to apply for this position.
URLstringURL of the position in Comeet, accessible for Comeet users only.
url_comeet_hosted_pagestringURL of the position’s page on the Comeet-hosted website. It is possible to refer applicants to this web page.
url_active_pagestringURL of the current position’s page according to the position’s settings. Could be either on the company’s website or on the Comeet-hosted website. It is possible to refer applicants to this web page.
experience_levelstringThe position's Seniority field.
employment_typestringThe position's Employment field.
internal_use_custom_idstringThe position’s id as defined by the company (not to be confused with the UID of the position).
picture_urlstringURL for the public position image for display and share on social media.
time_updatedtimestamp
company_namestring
position_urlstringURL for receiving the position object through the API.
is_talent_poolbooleantrue means that this position is a talent pool
locationobject
location.namestring
location.countrystring
location.citystring
location.statestring
location.postal_codestring
location.street_namestring
location.arrival_instructionsstring
location.street_numberstring
location.timezonestring
location.uidstring
salary_rangeobjectPosition salary range. Permission to read positions salary range is required.
salary_range.minint
salary_range.maxint
salary_range.currency_codestringCurrency using 3 letters code (ISO 4217)
salary_range.periodstringOne of the following:
hourly
weekly
monhtly
annually
categoriesarrayCustom categories.
categories[].namestring
categories[].valuestring
categories[].orderint
detailsarrayFree-form text details.
details[].namestring
details[].valuestringHTML
details[].orderint
usersobject
users.lead_recruiterobjectReceiving this object requires permission.
users.lead_recruiter.first_namestring
users.lead_recruiter.last_namestring
users.lead_recruiter.emailstring
users.lead_recruiting_coordinatorobjectReceiving this object requires permission.
users.lead_recruiting_coordinator.first_namestring
users.lead_recruiting_coordinator.last_namestring
users.lead_recruiting_coordinator.emailstring
referral_bonusobjectEnabled only for employee portal
referral_bonus.valuestring
referral_bonus.is_company_defaultbooleantrue if the value that returns is the company default.
false if the value is set for a specific position.
{  
  "uid": "87.405",
  "name": "Account Executive, Austin",
  "status": "open",
  "is_discreet": false,
  "is_published": true,
  "department": "Sales",
  "email": "[email protected]",
  "URL": "http://app.comeet.co/app/?goto_url=/req/1234",
  "url_comeet_hosted_page": "https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "url_active_page": "https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "employment_type": "Full-time",
  "experience_level": "Intermediate",
  "internal_use_custom_id": null,
  "picture_url": "https://comeet-euw-app.s3.amazonaws.com/53/b5ac4af700dfe6d749a862f7ba267f288f6cb575",
  "time_updated": "2017-05-26T14:22:46Z",
  "company_name": "Company Name",
  "position_url": "https://www.comeet.co/careers-api/2.0/company/30.005/positions/87.405?token=359F1DD13E1DD1DD1A813E6A6A",
  "is_talent_pool": false,
  "location":{  
    "name": "Austin, TX",
    "country": "US",
    "city": "Austin",
    "state": "TX",
    "postal_code": "",
    "street_name": "",
    "arrival_instructions": null,
    "street_number": "",
    "timezone": "America/Iqaluit",
    "uid": "D00.000"
  },
   "salary_range": {
   	"min": 200000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "categories":[  
    {  
      "name": "Territory",
      "value": "USA",
      "order": 1
    }
    //...
  ],
  "referral_bonus"”: {
    	"“value"”: "200 USD",
			"is_company_default": true
},

  "details":[  
    {  
      "name": "Description",
      "value": "We are looking for ...",
      "order": 1
    },
    {  
      "name": "Requirements",
      "value": "Candidates should have ...",
      "order": 2
    }
    //,,,
  ],
  "users": {
    "lead_recruiter": {
      "first_name": "Brandon",
      "last_name": "Liao",
      "email": "[email protected]"
    },
    "lead_recruiting_coordinator": {
      "first_name": "Stephanie",
      "last_name": "Simon",
      "email": "[email protected]"
    }
  }
}