Search for a Business

GET

BusinessLookup

curl --request GET \
  --url https://api.creditriskmonitor.com/v1/BusinessLookup \
  --header 'Authorization: <api-key>'

{
  "Success": true,
  "Data": [
    {
      "BusinessId": 123,
      "PrimaryBusinessName": "<string>",
      "Address1": "<string>",
      "Address2": "<string>",
      "CityName": "<string>",
      "StateCode": "<string>",
      "PostalCode": "<string>",
      "CountryName": "<string>",
      "CountryCode": "<string>",
      "PhoneNumber": "<string>",
      "TradingStatus": "<string>",
      "IncorporatedDate": "<string>",
      "IncorporatedIn": "<string>",
      "IncorporatedInState": "<string>",
      "TickerSymbol": "<string>",
      "StockExchange": "<string>",
      "FederalTaxId": "<string>",
      "CIKNumber": "<string>",
      "LatestStatementDate": "2023-11-07T05:31:56Z",
      "Employees": 123,
      "EmployeesAsOfDate": "2023-11-07T05:31:56Z",
      "MarketCap": 123,
      "BusinessNameOfMatch": "<string>",
      "Address1OfMatch": "<string>",
      "Address2OfMatch": "<string>",
      "CityNameOfMatch": "<string>",
      "StateCodeOfMatch": "<string>",
      "PostalCodeOfMatch": "<string>",
      "CountryCodeOfMatch": "<string>",
      "PhoneNumberOfMatch": "<string>",
      "FaxNumberOfMatch": "<string>",
      "FriskScore": 123,
      "FriskScoreDate": "2023-11-07T05:31:56Z",
      "PayceScore": 123,
      "PayceScoreDate": "2023-11-07T05:31:56Z",
      "MoodysIssuerCount": 123,
      "FitchRatingCount": 123,
      "BankruptcyCount": 123,
      "JudgmentCount": 123,
      "LienCount": 123,
      "BusinessNewsCount": 123,
      "TradePayments": true,
      "ParentBusinessId": 123
    }
  ],
  "ErrorCode": "<string>"
}

Use the Login endpoint to retrieve the SessionKey, then include it in the Authorization field for authentication.

Authorizations

Authorization

string

header

required

Enter the Session Key with the Bearer prefix, e.g. "Bearer abcde12345".

Query Parameters

BusinessName

string

Name of a Business to search for

PageSize

integer

Number of rows to return

MatchType

string

How to match the Business. NM: Name Match. PN: Phone Match. TS: Ticker Symbol Match. TI: TaxId Match TW: Ticker Symbol Wildcard Match.

StreetAddress

string

Street Address to search against

CityName

string

City Name to search against

ProvinceName

string

State / Province to search against

PostalCode

string

Zip / Postal code to search against

CountryCode

string

Two digit code of the country

PhoneNumber

string

Phone Number to search against.

TickerSymbol

string

Ticker Symbol to search against.

FederalTaxId

string

Federal Tax Id to search against.

Threshold

integer

Match Threshold

SearchUniverse

string

A: All businesses. P: Public companies only.

Response

200

application/json

Success

boolean

Data

object[]

Holds a Business for the API

Data.BusinessId

integer

ID of the Business

Data.PrimaryBusinessName

string

Name of the Business

Data.Address1

string

Address of the Business

Data.Address2

string

Secondary Address of the Business

Data.CityName

string

City of the Business

Data.StateCode

string

Two Digit State / Province code

Data.PostalCode

string

Zip / Postal code for the Business

Data.CountryName

string

Country name for the Business

Data.CountryCode

string

Two digit Country Code for the Business

Data.PhoneNumber

string

Phone Number for the Business

Data.TradingStatus

string

Trading Status for the Business

Data.IncorporatedDate

string

Date the Business was Incorporated

Data.IncorporatedIn

string

City the Business was Incorporated In

Data.IncorporatedInState

string

State the Business was Incorporated In

Data.TickerSymbol

string

Ticker Symbol for the Business

Data.StockExchange

string

Stock Exchange the Business is in

Data.FederalTaxId

string

Federal Tax Id for the Business

Data.CIKNumber

string

Central Index Key for the Business

Data.LatestStatementDate

string

Date of the Latest Statement for the Business

Data.Employees

integer

Number of Employees in the Business

Data.EmployeesAsOfDate

string

Date the Number of Employees is accurate as of

Data.MarketCap

integer

Market Capitalization for the Business

Data.BusinessNameOfMatch

string

Business Name found from Matching

Data.Address1OfMatch

string

Address1 found from Matching

Data.Address2OfMatch

string

Address2 found from Matching

Data.CityNameOfMatch

string

City Name found from Matching

Data.StateCodeOfMatch

string

State Code found from Matching

Data.PostalCodeOfMatch

string

Zip/Postal Code found from Matching

Data.CountryCodeOfMatch

string

Country Code found from Matching

Data.PhoneNumberOfMatch

string

Phone Number found from Matching

Data.FaxNumberOfMatch

string

Fax Number found from Matching

Data.FriskScore

integer

FRISKScore of the Business

Data.FriskScoreDate

string

Date of the FRISKScore

Data.PayceScore

integer

PAYCEScore of the Business

Data.PayceScoreDate

string

Date of the PAYCEScore

Data.MoodysIssuerCount

integer

If the Business has a Moodys Rating

Data.FitchRatingCount

integer

If the Business has a Fitch Rating

Data.BankruptcyCount

integer

Count of Bankruptcies for the Business

Data.JudgmentCount

integer

Count of Judgements for the Business

Data.LienCount

integer

Count of Liens for the Business

Data.BusinessNewsCount

integer

Count of News for the Business

Data.TradePayments

boolean

If Trade Payments are available

Data.ParentBusinessId

integer

The BusinessId of the Parent Business if this Business is a Subsidiary

ErrorCode

string

Was this page helpful?

Data Fields - Essentials Fetch Business Data

curl --request GET \
  --url https://api.creditriskmonitor.com/v1/BusinessLookup \
  --header 'Authorization: <api-key>'

{
  "Success": true,
  "Data": [
    {
      "BusinessId": 123,
      "PrimaryBusinessName": "<string>",
      "Address1": "<string>",
      "Address2": "<string>",
      "CityName": "<string>",
      "StateCode": "<string>",
      "PostalCode": "<string>",
      "CountryName": "<string>",
      "CountryCode": "<string>",
      "PhoneNumber": "<string>",
      "TradingStatus": "<string>",
      "IncorporatedDate": "<string>",
      "IncorporatedIn": "<string>",
      "IncorporatedInState": "<string>",
      "TickerSymbol": "<string>",
      "StockExchange": "<string>",
      "FederalTaxId": "<string>",
      "CIKNumber": "<string>",
      "LatestStatementDate": "2023-11-07T05:31:56Z",
      "Employees": 123,
      "EmployeesAsOfDate": "2023-11-07T05:31:56Z",
      "MarketCap": 123,
      "BusinessNameOfMatch": "<string>",
      "Address1OfMatch": "<string>",
      "Address2OfMatch": "<string>",
      "CityNameOfMatch": "<string>",
      "StateCodeOfMatch": "<string>",
      "PostalCodeOfMatch": "<string>",
      "CountryCodeOfMatch": "<string>",
      "PhoneNumberOfMatch": "<string>",
      "FaxNumberOfMatch": "<string>",
      "FriskScore": 123,
      "FriskScoreDate": "2023-11-07T05:31:56Z",
      "PayceScore": 123,
      "PayceScoreDate": "2023-11-07T05:31:56Z",
      "MoodysIssuerCount": 123,
      "FitchRatingCount": 123,
      "BankruptcyCount": 123,
      "JudgmentCount": 123,
      "LienCount": 123,
      "BusinessNewsCount": 123,
      "TradePayments": true,
      "ParentBusinessId": 123
    }
  ],
  "ErrorCode": "<string>"
}

Overview

Business Information

Financial Data

Portfolio Management

News Management

User Management

Trade Receivables

Authorizations

Query Parameters

Response