Bullhorn icon

Bullhorn

Interact with Bullhorn CRM API

Placement → Get Many

AI-generated

Summary

Retrieve multiple placements from Bullhorn using SQL WHERE clause or Lucene full-text search syntax.

Inputs

  • fields — Comma-separated list of fields to return. Available fields: id, appointments, approvingClientContact, billingClientContact, billingFrequency, bonusPackage, candidate, clientBillRate, clientOvertimeRate, comments, commissions, costCenter, dateAdded, dateBegin, dateClientEffective, dateEffective, dateEnd, dateLastModified, daysGuaranteed, daysProRated, durationWeeks, employeeType, employmentStartDate, employmentType, exemptionStatus, fee, hoursOfOperation, hoursPerDay, isWorkFromHome, jobOrder, jobSubmission, location, markUpPercentage, notes, optionsPackage, overtimeRate, owner, payGroup, payRate, placementCertifications, positionCode, referralFee, referralFeeType, reportTo, salary, salaryUnit, shift, statementClientContact, status, tasks, taxRate, taxState, terminationReason, timeUnits, vendorClientCorporation, workWeekStart, plus customDate1-13, customFloat1-23, customInt1-23, customText1-60, customTextBlock1-10.
  • searchType — Search strategy to use for retrieving placements.
  • queryString (required) — SQL WHERE syntax (e.g. candidate.id=123 AND status='Placed'). Required when searchType is Query (SQL).
  • queryString (required) — Lucene query syntax (e.g. status:Placed). Required when searchType is Search (Lucene).
  • returnAll — Whether to return all results or only up to a given limit.
  • limit — Maximum number of results to return. Only applies when Return All is false. Default 50, max 500.

Output shape

An array of placement objects. If Return All is false, up to Limit items are returned. If Return All is true, all matching placements are returned across all pages.

Uses Bullhorn /query/ or /search/ endpoints depending on searchType. Fields parameter filters returned columns. SearchType defaults to Query (SQL).

Examples

Example 1: Retrieve all active placements for a candidate.

Set fields to id,candidate,jobOrder,status; searchType to Query; queryString to candidate.id=123 AND isDeleted=false; returnAll to false; limit to 50.

Links

Discussion