BQ KYB Append API (V2.2)

Overview

This API is a powerful tool that delivers Company Firmographic, Financial and Legal Entity level data for 102M Organizations doing business in the US. This API can search Company and People based information.

For Company Lookup

  • This API allows businesses to leverage up-to-date company information using various valuable data points, such as company name, address (including HQ address, Legal Entity address, and any other address), headcount, or industry, and generate business opportunities, discover industry trends, and unlock market insights
  • The API provides access to a wide range of financial statements, including income statements, balance sheets, and cash flow statements. These statements are crucial for analyzing a company’s financial health and performance.
  • The API provides information related to corporate family tree structure and compliance checks that help businesses with identity as well as verification of the legal status of the company.

For People Lookup

  • The API provides a person's contact details (LinkedIn URL, email, phone numbers, address), job title, and associated company information.

Input Parameters

The Company Lookup enables a client to search for a Company or Legal Entity using input parameters such as:

  • BQ ID
  • Company Name
  • Company Address
  • Website URL
  • Ticker
  • EIN
  • CIK

The People Lookup enables a client to search for an Executive and associated company information using:

  • Executive Name
  • Executive LinkedIn URL
  • Executive Email

Output Parameters

For Company Lookup include Organization

  • Firmographics with Revenue and Employment Ranges
  • Financials including balance sheet items, cash flow, and income statements
  • Most Recent Employment and Payroll
  • Legal Entity details, BQ Credit Score, Tax Liens, and related financial health indicators

For people lookup includes Executive

  • Contact Information
  • Job Title
  • Address
  • Associated Company Information

Use Cases

  • Capital Market
  • Sales & Marketing
  • Compliance and KYB / KYC
  • Credit Risk: Insurance & Banking

Please refer to this link for detailed Use Cases and Field Names

Technology & Matching Logic

BQ’s proprietary search algorithms utilize multiple matching methods and rank results using a combination of proximity and company size, giving preference to larger and more relevant organizations.

Authentication Method

The API supports the following authentication method:

  • API Key

Method: POST

You can use the API Endpoint to supply your API Key.

Postman Setup

Follow the steps below to implement authentication in Postman:

  • Select Method as POST and add the Endpoint URL.
  • Click the Authorization tab and choose Basic Auth.
  • Supply your API Key.

BQ Company Lookup API

Organization: An organization is a company which represents a collection of legal entities that are under common control; this table contains basic identifying information on the organization, and how it links to its component legal entities; type of hierarchy.

API Endpoint

https://apigw.brightquery.com/search/append/org

Parameters Data TypeDescription
company_nameString
Organization Name
Example: bq_company_name=FLOWERS FOODS INC
BQ IDString
Unique ID assigned by BQ to the Organization.
Example: bq_id=100003273517
tickerString
TICKER of the Organization if it is public.
Example: bq_ticker=FLO
ticker_parentString
TICKER of the Organization's parent holding company if the parent is publicly listed.
Example: bq_ticker_parent='FLO'
ticker_relatedString
All TICKERs associated with the Organization if it is publicly listed.
Example: bq_ticker_related='FLO'
leiString
Legal Entity Identifier of the Organization.
Example: bq_organization_lei=7YNCQQNDK8FBM9BBTK25
cikString
CIK of Organization.
Example: bq_cik=0001128928
linkedin_urlString
Organization LinkedIn URL.
Example: bq_company_linkedin_url=https://www.linkedin.com/company/flowers-foods
addressString
Address of Organization.
Example: bq_company_address1_line_1=1919 Flowers Cir Thomasville, GA 31757
websiteString
Website of Organization.
Example: bq_website=https://www.flowersfoods.com
einString
EIN of Organization.
Example: bq_company_ein=582582379
emailString
Email of the contact.
Example: email=jthompson@suremail.info

Name + Address
{
    "company_name": "Flower",
    "address": "1919 Flowers Cir Thomasville"
}
Name + Website
{
"company_name": "Flower",
"website": "www.flowersfoods.com"
}
Name Only
{
      "company_name": "Flower"
    }
Website Only
{
      "website": "www.flowersfoods.com"
    }
Ticker Only
{
      "ticker": "FLO"
    }
EIN Only
{
      "ein": "27-4827982"
    }
LinkedIn URL
{
      "linkedin_url": "www.linkedin.com/flowers"
    }
LEI Only
{
      "lei": "7YNCQQNDK8FBM9BBTK25"
    }
CIK Only
{
    "cik": "0000051143"
    }
BQ ID Only
{
      "bq_id": "100003273517"
    }

The number of records per hit is 10.

Records are sorted by revenue and employees headcount

BQ People Lookup API

Organization-level Executives including first & last name, job title, email (personal, office), phone, LinkedIn URL, address.

API Endpoint

https://apigw.brightquery.com/search/append/executives

Parameters Data TypeDescription
executive_nameString
Full name of the Executive.
Example: executive_name=JOHN W THOMPSON
linkedin_urlString
Executive LinkedIn URL.
Example: linkedin_url=linkedin.com/in/john-thompson-314312116
emailString
Email address of the Executive.
Example: email=jthompson@suremail.info

Name
{
    "executives_name":"JOHN W THOMPSON"
}
LinkedIn URL
{
    "linkedin_url":"linkedin.com/in/john-thompson-314312116"
}
Email
{
    "email":"jthompson@suremail.info"
}

The number of records per hit is 10.

Table of Contents

Overview

Parameters

Use Cases

Authentication

Company Lookup API

People Lookup API