Business Verification API - US

Overview & Purpose
The Business Verification API provides a complete toolkit for companies that need to verify the legitimacy of a business during onboarding, when underwriting a financial product, while conducting a compliance screening, or during any number of other use cases. The API takes a limited set of inputs and generates a complete and up-to-date report that can be used to automate any number of workflows
These APIs collectively offer a robust solution for accessing business information in the United States. Designed to streamline processes related to company onboarding, verification, and detailed data retrieval, they cater to a variety of use cases, from initial setup to in-depth business intelligence.
The Create Business Information API acts as a facilitator for users to input and verify crucial company details, including company name, address, and specific product orders, emphasizing the establishment of the business entity's identity and legal standing. This API is tailored to support a seamless onboarding process. On the other hand, the Retrieve Business Information API offers users the ability to access a wealth of information about a business by providing a unique business ID. Together, these APIs cater to a spectrum of use cases, from initial onboarding and verification to detailed data retrieval for informed decision-making and compliance.
Key Capabilities:
The integrated capabilities of these APIs provide a robust solution for managing business information in the United States. The Business Creation and Verification aspect empowers users to seamlessly establish and confirm business profiles, submit orders for product verification, and specific document validation. Meanwhile, the Comprehensive Data Retrieval functionality allows users to access a wealth of business details using a unique business ID, covering aspects such as business name, status, supported document types, and downloadable documents.
Use Cases:
Onboarding and Verification:
Smooth onboarding process with accurate business details and verification.
Due Diligence:
In-depth exploration for due diligence purposes, ensuring compliance and legal adherence.
Business Intelligence:
Comprehensive data retrieval for strategic decision-making and business intelligence.
﻿
These APIs collectively provide a comprehensive solution, empowering users to manage and retrieve vital business information, fostering efficiency, compliance, and informed decision-making in the realm of United States business operations.
Business Report
The Business Report API is a straightforward tool designed to provide you with essential insights into any company. It consolidates information into a comprehensive PDF document, simplifying the process of understanding a business. Below is a guide to what you can expect from the reports generated by our API.
1. Company Snapshot:
Company Name: Obtain the official name of the business entity.
Address: Access the registered business address for correspondence and validation.
Status: Instantly determine the current status of the business – active, inactive, or other.
2. Watchlist Hits:
Alerts: Stay informed about any matches found on watchlists, providing insights into potential risks or concerns.
3. SOS Filings:
Filing Status: Gain insights into the filing status, whether successful, partially inactive, or encountering issues.
Inactive Filings: Identify the number of inactive filings and receive warnings for filings with no provided status or domestic registration.
4. Business Verification:
Name Verification: Confirm the match of the business name to the submitted information.
Address Verification: Validate the match of the office address, with additional details like USPS mail delivery and commercial property status.
The API generates comprehensive reports, consolidates findings, and provides you with a PDF document for easy reference. Whether you're a business professional, investor, or researcher, the API empowers you with the critical information you need for confident decision-making. Explore the capabilities of our Business Report API to streamline your access to essential business insights.
﻿
API Details
Create Business - Sample cURL
API Input 
Pre-Production
Production
Curl
curl --location 'https://api-preproduction.signzy.app/api/v3/us-kyb/create-business-us' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Kong-auth-token>' \
--data '{
   "name":"Energy Transfer LP",
   "addressLine1":"Energy Transfer",
   "addressLine2":"8111 Westchester Drive",
   "city":"Dallas",
   "state":"TX",
   "postalCode":"75225",
   "tin":"300108820",
   "formationState":"TX",
   "entityType":"PARTNERSHIP",
   "websiteUrl":"https://www.energytransfer.com/",
   "products":[
      "business_verification_verify",
      "tin",
      "website",
      "documents",
      "ucc_liens",
      "tax_leins",
      "bankruptcies",
      "litigations"
   ],
   "subproducts":[
      "Articles of Incorporation",
      "Certificate of Good Standing",
      "ucc_documents"
   ]
}'

curl --location 'https://api-preproduction.signzy.app/api/v3/us-kyb/create-business-us' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Kong-auth-token>' \
--data '{
   "name":"Energy Transfer LP",
   "addressLine1":"Energy Transfer",
   "addressLine2":"8111 Westchester Drive",
   "city":"Dallas",
   "state":"TX",
   "postalCode":"75225",
   "tin":"300108820",
   "formationState":"TX",
   "entityType":"PARTNERSHIP",
   "websiteUrl":"https://www.energytransfer.com/",
   "products":[
      "business_verification_verify",
      "tin",
      "website",
      "documents",
      "ucc_liens",
      "tax_leins",
      "bankruptcies",
      "litigations"
   ],
   "subproducts":[
      "Articles of Incorporation",
      "Certificate of Good Standing",
      "ucc_documents"
   ]
}'
﻿
Curl
curl --location 'https://api.signzy.us/api/v3/us-kyb/create-business-us' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Kong-auth-token>' \
--data '{
   "name": "<Company Name>",
   "addresses": [
       {
           "addressLine1": "<Address Line 1>",
           "addressLine2": "<Address Line 2>",
           "city": "<City>",
           "state": "<State Code>",
           "postalCode": "<Postal Code>"
       }
   ],
   "orders": [
       {
           "product": "business_verification_verify"
       },
       {
           "product": "documents",
           "subproducts": [
               "Articles of Incorporation",
               "Certificate of Good Standing"
           ]
       }
   ]
}'
curl --location 'https://api.signzy.us/api/v3/us-kyb/create-business-us' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Kong-auth-token>' \
--data '{
   "name": "<Company Name>",
   "addresses": [
       {
           "addressLine1": "<Address Line 1>",
           "addressLine2": "<Address Line 2>",
           "city": "<City>",
           "state": "<State Code>",
           "postalCode": "<Postal Code>"
       }
   ],
   "orders": [
       {
           "product": "business_verification_verify"
       },
       {
           "product": "documents",
           "subproducts": [
               "Articles of Incorporation",
               "Certificate of Good Standing"
           ]
       }
   ]
}'
﻿
API Input Mapping
Field
Type
Required/Optional
Description
name
string
Required
The legal name of the Business you are verifying. This should be the name the Business has registered with the U.S. IRS or the Secretary of State in their state of incorporation.
addresses
object
Required
A list including the physical addresses of a business. For larger companies, this commonly includes the address of their headquarters (HQ) location.
addressLine1
string
Required
Address line one of the company
addressLine2
string
Optional
Address line two of the company
city
string
Required
City where the office is located
state
string
Required
State the office is located(can be any branch of the company registered with Govt.)
postalCode
string
Required
Postal code of the office located
tin
Object
Optional
A unique 9-digit number that is used by the IRS to identify a business entity. Must be passed to conduct TIN verification.
websiteUrl
﻿
﻿
﻿
entityType
﻿
﻿
﻿
product
string
Optional
Type of product ordered
subproducts
object
Optional
Array of sub-products
API Output
200
{
    "result": {
        "object": "business",
        "businessId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
        "name": "<Company Name>",
        "status": "open",
        "names": [],
        "addresses": [],
        "submitted": {}
    }
}
{
    "result": {
        "object": "business",
        "businessId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
        "name": "<Company Name>",
        "status": "open",
        "names": [],
        "addresses": [],
        "submitted": {}
    }
}
﻿
API Output Mapping
Field
Data Type
Description
object
Object
Refers to business object here.
businessId
String
Refers to the ID which needs to be used in the further process.
name
String
Refers to the business name which business data is being retrieved for.
status
Object
Status of the request
names
Object
Object refers to the
addresses
String
Gives details about the address of the company which was entered previously.
submitted
String
Gives a confirmation of the basic information entered in the input including address and orders placed.
﻿
Retrieve Business - Sample cURL
API Input
Pre-Production
Production
Curl
curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyb/retrieve-business-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: < Auth Token >' \
--data '{
    "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}'
curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyb/retrieve-business-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: < Auth Token >' \
--data '{
    "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}'
﻿
Curl
curl --location 'https://api.signzy.us/api/v3/us-kyb/retrieve-business-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: < Auth Token >' \
--data '{
    "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}'
curl --location 'https://api.signzy.us/api/v3/us-kyb/retrieve-business-us' \
--header 'Content-Type: application/json' \
--header 'Authorization: < Auth Token >' \
--data '{
    "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}'
﻿
API Input Mapping
Field
Type
Required/Optional
Description
businessId
string
Required
The id number which helps us retrieve information about company.
API Output
200
{
    "result": {
        "object": "business",
        "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
        "businessName": "<company name>",
        "status": "in_review",
        "supportedDocuemntTypes": {
            "0": "Certificate of Good Standing", "Article of Incorporation"
        },
        "documents": [],
        "businessReportPdf": "< persist url >",
        "review": {},
        "formation": {},
        "watchlist": {},
        "names": [],
        "addresses": [],
        "people": [],
        "registrations": [],
        "fmscaRegistrations": [],
        "submitted": {}
    }
}
{
    "result": {
        "object": "business",
        "businessId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
        "businessName": "<company name>",
        "status": "in_review",
        "supportedDocuemntTypes": {
            "0": "Certificate of Good Standing", "Article of Incorporation"
        },
        "documents": [],
        "businessReportPdf": "< persist url >",
        "review": {},
        "formation": {},
        "watchlist": {},
        "names": [],
        "addresses": [],
        "people": [],
        "registrations": [],
        "fmscaRegistrations": [],
        "submitted": {}
    }
}
﻿
API Output Mapping
Field
Data Type
Data Type
object
Object
Refers to “business”
businessId
String
Refers to the ID which was used in the process to retrieve data
businessName
Object
Refers to the business name which business data is being retrieved for.
status
String
Status of the Request.
supportedDocuemntTypes
String
Documents that are supported as part of this request.
documents
String
Link for downloading the supported documents.
businessReportPdf
String
Link for downloading the business PDF report.
review
Object
Gives information about Watchlist , Watchlist Source,  SOS Activity, Addresses,  People.
formation
Object
Gives information about the entity type
watchlist
Object
Gives the watchlist information related to the company searched against with source.
names
Object
Gives the activity status about the company at different jusristrictions the company is located at.
addresses
Object
Give with array of elements about the addresses associated with the company.
people
Object
Gives information about important people holding position in the company.
registrations
Object
Gives information about the registered offices and officers holding position in the company
fmscaRegistrations
Object
Provides information about any registrations in Federal Motor Carrier Safety Administration.
submitted
Object
Gives a confirmation of the basic information entered in the input including address and orders placed.
Error Code Response & Mapping
400 (Bad Request)
401(Unauthorized)
403 (Forbidden)
500 (Internal Server Error)
409(Upstream Down)
{
  "error": {
     "name": "error",
     "message": "Upstream down",
     "status": 409,
     "reason": "ERROR",
     "type": "Conflict",
     "statusCode": "409"
  }
}
{
  "error": {
     "name": "error",
     "message": "Upstream down",
     "status": 409,
     "reason": "ERROR",
     "type": "Conflict",
     "statusCode": "409"
  }
}
﻿
Field
Type
Description
name
string
Text displayed on the screen explaining error type.
reason
string
Reason for the error.
status
number
HTTP status code.
message
string
Error message indicating an upstream error.
type
string
Error type.
statusCode
string
Status code representing the error scenario.
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
﻿

Field	Type	Required/Optional	Description
name	string	Required	The legal name of the Business you are verifying. This should be the name the Business has registered with the U.S. IRS or the Secretary of State in their state of incorporation.
addresses	object	Required	A list including the physical addresses of a business. For larger companies, this commonly includes the address of their headquarters (HQ) location.
addressLine1	string	Required	Address line one of the company
addressLine2	string	Optional	Address line two of the company
city	string	Required	City where the office is located
state	string	Required	State the office is located(can be any branch of the company registered with Govt.)
postalCode	string	Required	Postal code of the office located
tin	Object	Optional	A unique 9-digit number that is used by the IRS to identify a business entity. Must be passed to conduct TIN verification.
websiteUrl
entityType
product	string	Optional	Type of product ordered
subproducts	object	Optional	Array of sub-products

Field	Data Type	Description
object	Object	Refers to business object here.
businessId	String	Refers to the ID which needs to be used in the further process.
name	String	Refers to the business name which business data is being retrieved for.
status	Object	Status of the request
names	Object	Object refers to the
addresses	String	Gives details about the address of the company which was entered previously.
submitted	String	Gives a confirmation of the basic information entered in the input including address and orders placed.

Field	Type	Required/Optional	Description
businessId	string	Required	The id number which helps us retrieve information about company.

Field	Data Type	Data Type
object	Object	Refers to “business”
businessId	String	Refers to the ID which was used in the process to retrieve data
businessName	Object	Refers to the business name which business data is being retrieved for.
status	String	Status of the Request.
supportedDocuemntTypes	String	Documents that are supported as part of this request.
documents	String	Link for downloading the supported documents.
businessReportPdf	String	Link for downloading the business PDF report.
review	Object	Gives information about Watchlist , Watchlist Source, SOS Activity, Addresses, People.
formation	Object	Gives information about the entity type
watchlist	Object	Gives the watchlist information related to the company searched against with source.
names	Object	Gives the activity status about the company at different jusristrictions the company is located at.
addresses	Object	Give with array of elements about the addresses associated with the company.
people	Object	Gives information about important people holding position in the company.
registrations	Object	Gives information about the registered offices and officers holding position in the company
fmscaRegistrations	Object	Provides information about any registrations in Federal Motor Carrier Safety Administration.
submitted	Object	Gives a confirmation of the basic information entered in the input including address and orders placed.

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	string	Status code representing the error scenario.

Did this page help you?

EIN Lookup

Business Verification US - Document Fetch

Business Verification API - US

Overview & Purpose

Key Capabilities:

Use Cases:

Business Report

﻿

API Details

Create Business - Sample cURL

API Input

API Input Mapping

API Output

API Output Mapping

﻿

Retrieve Business - Sample cURL

API Input

API Input Mapping

API Output

API Output Mapping

Error Code Response & Mapping

Getting help