Ashby Analytics
...
Lever API Key Setup
The Lever Data Model
7 min
this document gives a brief introduction to the primary working objects of lever’s data model and what it all means for reporting considerations core lever concepts the following objects are core to lever's data model and reporting candidate the individual applying to one or multiple jobs the candidate object holds the candidate related fields name, resume, credentials and other information not unique to any specific job application job posting (“job”) the job posting promoting a job where candidates can apply the job posting contains metadata about the job, such as the department, location and hiring team members opportunity a candidate’s application on a specific job is called an opportunity a candidate can apply to multiple jobs and thus have multiple active opportunities the opportunity object contains metadata unique to the application, such as the origin, source and hiring team members assigned scorecard feedback, interview records, and additional progress information will be tied to the opportunity requisition requisitions are https //help lever co/hc/en us/articles/208252716 how do i add requisitions to lever , but if you use them this will be where headcount information, budget specification and approval workflows can live the requisition contains metadata about department, team, and hiring team members, amongst other details in addition to the requested headcount concept and reporting challenges to keep in mind the job, the opportunity, and the requisition each have a recruiter each core lever object has an independent record of common fields, such as the recruiter and hiring manager sometimes these are the same across these objects, but they can differ! sometimes the opportunity's recruiter is not the same as the recruiter on the job posting associated with the opportunity, for example each core lever object has an independent record of common fields, such as the recruiter and hiring manager sometimes these are the same across these objects, but they can differ! sometimes the opportunity's recruiter is not the same as the recruiter on the job posting associated with the opportunity, for example many customers request reporting, grouping or filtering by “the recruiter” or “the hiring manager ” these hiring team roles can be assigned on the job, but they can also be specified on the opportunity or the requisition record independently this can result in data divergence, where an opportunity can have one recruiter assigned, and the job itself can have a different recruiter assigned to make matters a little more complicated, the requisition can also have a different assigned recruiter there is no constraint within lever that requires the different objects have the same hiring team member assigned in ashby, you can report with specification of the field on any of these objects as you use type ahead on the field selector, you'll see the "path" from which the field is selected, e g "opportunity > recruiter" will select the recruiter from the opportunity, while "opportunity > job > recruiter" will select the recruiter specified on the job's record our recommendation most customers report based on the opportunity’s hiring team members, but you can use ashby to examine the job’s and requisition’s assigned recruiter and compare that against the opportunity’s recruiter to detect any unexpected discrepancies job postings and requisitions are independent objects job postings and requisitions can be created independently of each other and at any time this means you can have a job posting open with active opportunities and no underlying requisition is required however, you can link one or many job postings to a requisition at any point in time similar to understanding which object’s hiring team members you want to reference in reporting, metadata around the department, team, location and so on can differ between the requisition and the job posting a requisition is only associated with an opportunity at the offer or hired stage within lever’s model, an opportunity is only associated with the requisition at the time of offer approval or extension, or after a hire is made this means that any candidate or opportunity related reporting by requisitions necessarily will be implicitly filtered to opportunities at the offer or hired stages time to fill is not well defined in lever as described above, job postings and requisitions are independent and the relationship between them is “many to many” in lever this means a job posting can be associated with multiple requisitions, and a requisition can be associated with multiple job postings a byproduct of this is a job posting can be opened and with active opportunities in the pipeline, and then at a later date, a new requisition can be opened the requisition’s creation time does not necessarily precede recruiting efforts, so the notion of a “start time” is not clear given a single requisition can be associated with multiple job postings, the “close date” for a time to fill is also not clear is it the first hire across any posting, the first hire from each posting, or the date which the requisition itself is closed after all headcount is filled? our recommendation if you are using requisitions in lever, go with 1 headcount per requisition this will allow a clear requisition creation or approval date and requisition close date, from which we can report a best effort time to fill metric additionally, if you integrate with an hris like workday where you define your headcount, it’s likely the lever integration will follow a 1 requisition 1 headcount sync a candidate can have multiple opportunities it is tempting to report on “candidates”, but in most cases you do not want to, as the candidate does not contain meaningful data about progress through your interview funnel you’ll want to focus your reporting on opportunities, as discussed in docid 5aqpuely1gp4mkmnd fne working with lever’s offer process if your offers are managed outside of lever, you will not be able to report on offer acceptance rates effectively if you need to keep the offer letter outside of lever's system, we recommend you can create an offer object in lever and https //help lever co/hc/en us/articles/360030607532 how do i create an offer for an opportunity (see “how do i send an offer outside of lever?”) on this topic, we also recommend reviewing the ability to create offer custom fields that https //help lever co/hc/en us/articles/205802979 how do i customize the offer form (see “editable without requiring re approval”) summary there's a lot more to lever's data model than summarized above, but in our experience, a majority of reporting and reporting challenges relate to the topics covered here conceptually, one of the biggest takeaways here is that these core lever objects are mostly independent despite having some optional dependencies across each other, and the core fields of interest such as recruiter or hiring manager can be different on different objects this isn't a blocker, as we can help you report and identify such cases, but it is a point that can lead to unexpected results or confusion in report results if you have a question, or a specific point of interest or suggestions, feel free to reach out to the ashby team!