Dedicated Partner Job Feeds

Ashby can provision a dedicated job posting feed for a partner interested in ingesting job postings. Once the integration is live, Ashby customers can opt-in to sharing their jobs with the partner's service by enabling the partner's integration in the Admin section of the Ashby app. After this is done, all of their published job postings will be published to the feed for the partner to ingest.

The schema of the feed is fixed, but the format can be in JSON or XML formats. The data provided in JSON and XML feeds is identical between the feeds and is updated hourly.



If you are interested in obtaining a dedicated feed, contact [email protected]

Job Posting Schema

Job postings are provided in a flat list

idStringA UUID of the job posting.Yes
organizationIdStringA UUID of the organization.Yes
organizationNameStringThe name of the organization in Ashby.Yes
titleStringThe title of the job posting.Yes
departmentNameStringThe department of the job posting.Yes
teamNameStringThe team of the job posting.No
descriptionPlainStringThe job posting description in plain text .Yes
descriptionHtmlStringHTML block of the job posting description.Yes
employmentTypeStringThe type of employment. Will be one of the following: FullTime, PartTime, Intern, Contract, or Temporary.Yes
externalLinkStringA link to the application form.Yes
updatedAtStringThe UTC date time in GMT of when this job post was last updated.Yes
publishedAtStringThe UTC date time in GMT of when this job post was published.Yes
locationsArrayAn array of locations that this posting is assigned to (see below for location schema).Yes
compensationTiersArrayAn array of compensation tiers (see below for compensation schema).No

Location Schema

Location follows Place as defined by In particular, the postalAddress schema.

locationNameStringThe name of the location.Yes
addressObjectThe address of the location (see below for address schema).No
isRemoteBooleanIndicates if this job posting is eligible for remote work.Yes
isPrimaryLocationBooleanIndicates in this is the primary location if there are multiple locations for this posting. There can only be one primary location per posting.Yes

Address Schema

Address follows the postalAddress as defined at

addressCountryStringThe country of the location. This is NOT guaranteed to be a county code.No
addressRegionStringThe region (state, province, etc) of the location.No
addressLocalityStringThe locality (city, town, village, etc.) of the location.No
postalCodeStringThe postal code of the location.No
postOfficeBoxNumberStringThe PO box number of the location.No
streetAddressStringThe street address of the location.No

Compensation Schema

Ashby provides a rich set of compensation data comprising of compensationTiers. Each tier consists of a title, an array of components and an additionalInformation field.

Compensation Tier Schema

titleStringThe title of the tier.Yes
componentsArrayThe components that make up this compensation tier. They detail salary, commission, equity, and bonus structure.Yes
additionalInformationStringAny additional information that may be necessary to understand the tier.No

Compensation Component Schema

Each tier will have between 1 and 4 components that detail salary, commission, equity, and bonus structure.

compensationTypeStringThe type of compensation. Possible values are Salary, EquityPercentage, EquityCashValue, Bonus, and CommissionYes
summaryStringA generated summary of the component. Example: "Base Salary $70K – $100K"No
IntervalStringThe period on which this compensation is given. Possible values are NONE, 1 TIME, 1 HOUR, 1 DAY, 1 WEEK, 2 WEEK, 0.5 MONTH, 1 MONTH, 2 MONTH, 3 MONTH, 6 MONTH, and 1 YEARYes
minValueNumberThe minimum of this compensation range.Yes
maxValueNumberThe maximum of this compensation range.Yes
currencyCodeStringThe currency code this compensation component is paid in. Applied to all types except EquityPercentage,No

Meta Schema

Ashby also provides a meta object that contains additional information and context. At the moment, the only provided metadata is for organizations as outlined below.

idStringA UUID of the organization (matches organizationId in the job posting entry).Yes
nameStringThe name of the organization in Ashby (matches organizationName in job posting entry)Yes
linkStringA link to the organization's website.Yes
jobBoardLinkStringA link to the Ashby job board of the organization.Yes