Understanding API Usage Limits, Versioning, and Backward Compatibility

This article provides information on API Usage Limits, Versioning, and Backward Compatibility. To maintain a minimum level of performance and to ensure that the Bullhorn API is available to all of our customers, Bullhorn balances transaction loads by imposing limits on the following:

  • Concurrent API session limits

  • Total daily API request limits

  • Per minute API request limits

  • API Subscription limits - Think of a subscription as an application.

    • If you have one API key/user, you can use the same key/user for multiple applications.

    • If you use your API user for more than one application tied to Bullhorn, you will need to use the same API username/password across those multiple applications. This also means that when an API user appears in Bullhorn's edit history, you'll be unable to differentiate which API subscription was responsible for creating that edit history.

  • Time To Live (TTL) for unused subscriptions

  • TTL for unretrieved events

  • These limits are set according to the edition in use by your company.

Bullhorn is also continually improving the functionality and quality of the Bullhorn APIs through new releases and bug fixes. Bullhorn uses version numbers to separate releases that may change an interface already in use by existing customer applications.

Versions are designated by a change in the web service URL. For instance, version 1.0 of the API was available at https://api.bullhornstaffing.com/webservices-1.0/?wsdl while version 1.1 is available at https://api.bullhornstaffing.com/webservices-1.1/?wsdl. Any change in the number represents a change in version.

API users created by Bullhorn Support for Marketplace integrations do not count towards your API user limit.

Usage Limits

Editions with Limited API Access

  • Bullhorn ATS - User

  • Bullhorn ATS - Corporate

API Usage Limits:

  • Your company can have up to 25 concurrent API sessions at any point in time.

  • The total calls cannot exceed 100,000 per day.

  • Maximum number of calls per minute is 700.

  • The maximum number of API Subscriptions allowed is five.

  • Time To Live (TTL) for unused subscriptions is seven days.

  • TTL for unretrieved events is seven days.

Editions with Full API Access

  • Bullhorn ATS - Enterprise

  • Bullhorn Front Office Growth

  • Bullhorn Front Office Enterprise

  • Bullhorn Growth Edition - All Editions

  • Bullhorn One - All Editions

API Usage Limits:

  • Your company can have up to 50 concurrent API sessions at any point in time.

  • The total calls cannot exceed 2,000,000 per day.

  • Maximum number of calls per minute is 1500.

  • The maximum number of API Subscriptions allowed is 15.

  • Time To Live (TTL) for unused subscriptions is seven days.

  • TTL for unretrieved events is seven days.