Menu

Samenvatting van de Bullhorn API

De Bullhorn REST API is georganiseerd rond generieke operaties die op elk entity-type (Candidate, ClientContact, JobOrder, Placement, Note en tientallen andere) toepasbaar zijn. Daarnaast zijn er gespecialiseerde endpoints voor CV-parsing, file-management en services-integraties met payroll en revenue-recognition.
  • Kandidaat- en klantbeheer: CRUD op elk entity-type via `/entity`, inclusief effective-dated entities voor versiebeheer van locaties en placements.
  • Zoeken en rapporteren: Zoek via Lucene (`/search`), JPQL (`/query`), quick-find (`/find`) en beheer opgeslagen zoekopdrachten met delegatie en favorieten.
  • CV-parsing: Parse CV's direct naar Candidate-records, HR-XML of platte tekst, zowel via multipart-upload als JSON-payload.
  • Bestandsbeheer: Upload, update en verwijder bestanden per entiteit (CV's, contracten, documenten) en beheer profielfoto's van gebruikers.
  • Event-subscriptions: Poll op entity-wijzigingen via `/event/subscription` — zelf webhooks uitsturen gebeurt niet, maar je kunt continu pollen op id's.
  • Payroll- en finance-services: Aparte endpoints voor direct-deposit-accounts, revenue-recognition-batches, pay-export-status en placement-change-approvals.
API Quick Facts REST
  • Authenticatie OAuth2
  • Methods GET (25)POST (20)PUT (13)DELETE (8)
  • Rate limits Niet gespecificeerd
  • Webhooks Niet beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • SDK's Java

Laatste ontwikkelingen bij de Bullhorn API

Bullhorn lanceerde de publieke REST API als vervanger van de oudere SOAP-interface. De API is sinds de introductie uitgebreid met OAuth 2.0-authenticatie, sessie-tokens (BhRestToken), event-subscriptions voor change-tracking, CV-parsing via TextKernel en mass-update operaties. Effective-dated entities maken versiebeheer van placements en locaties mogelijk. De documentatie wordt beheerd als open-source project op GitHub (bullhorn/rest-api-docs) en een publieke Postman-collectie is beschikbaar. Data-center-specifieke URLs vereisen een initiële `loginInfo`-call om de juiste swimlane te vinden.

API versies

Event subscriptions Major release

Endpoints onder `/event/subscription` voor polling op entity-changes als alternatief voor webhooks.

Effective-dated entities Major release

Versiebeheer van entiteiten (Placement, Location) met `effectiveOn`-parameter voor historische en toekomstige waarden.

Revenue Recognition services Major release

Uitbreiding met `/services/RevenueRecognition/*` endpoints voor bill- en unbilled-revenue-distributie batches.

CV-parsing via JSON

Toevoeging van `*ViaJson`-varianten op alle resume-parsing-endpoints voor JSON-payload-uploads.