Company Surge® API

Company Surge® API Endpoints


Endpoint RequestDocumentation
Create a Company Surge® report
POST https://sentry.bombora.com/v4/Surge/Create
Click here
Upload a target account list for a Company Surge® report
POST https://sentry.bombora.com/v3/Surge/UploadSurgeFile
Click here
Get Company Surge® report results
GET https://sentry.bombora.com/v2/Surge/TryGetResult?id=reportid
Click here
Delete Company Surge® report
POST https://sentry.bombora.com/v4/Surge/Delete
Click here
Get Company Surge® report estimate
POST https://sentry.bombora.com/v4/Surge/Estimate
Click here
Get meta data information
GET https://sentry.bombora.com/v2/Surge/GetMetaData
Click here
Get list of Company Surge® reports
GET https://sentry.bombora.com/v4/Surge/GetList
Click here

Release Notes


December 11, 2020

You can now delete a Company Surge® report using the Delete endpoint. 

November 19, 2020

You can now upload include a blacklist file in the Create Company Surge® Report v4 endpoint to exclude domains from your Company Surge® report. 

October 26, 2020

Get a list of Company Surge® reports

Get a list of all of your Company Surge® reports using the new Get List of Company Surge® Reports endpoint.

Report Name

Better identify your Company Surge® report by including a report name in the  Create Company Surge® Report v4 endpoint.

September 24, 2020

A new "AutoGen" feature is now available in the Create Company Surge® Report v4 endpoint.

Include this field in your Company Surge® report to have the report automatically refresh on a weekly or monthly cadence.


August 6, 2020

A new topic cluster upload feature is now available in the Create Company Surge® Report v4 endpoint.

Include your topic clusters to understand the research activity of your target accounts on clusters related to your products or services.
For more information, check out 
the video.

December 6, 2018

We've created a new endpoint (Create Company Surge® Report v4) that includes the following changes:

  • Addition of Country & Country Company Surge® Score
  • Addition of State & State Company Surge® Score
  • Addition of Geographic Company Surge®Score Threshold
  • Removal of Zip Codes

Please find documentation for this endpoint here.

October 4, 2017

Added the ability to upload custom domain database files for creating Company Surge® reports. Upload a CSV or Excel with domains in the first column and keep your existing data in the following columns. Your output will append Company Surge data in the columns following your existing data.

Upload Your Database File for a Company Surge® Report

April 3, 2017

All results now return "Company Name" as the first column. If a company name is not available for a particular domain, that column will return an empty string.

March 1, 2017

For the Get Company Surge® Report Results endpoint, we have solved an issue that caused large files to stream slowly. We have moved our API to a different server, and response time on streaming should be improved.