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 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 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" {} } } 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 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 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" {} } } 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) { "error" { "name" "error", "message" "name is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 401(unauthorized) { "message" "invalid authentication credentials" } 403 (forbidden) { "error" { "name" "error", "message" "forbidden", "reason" "error", "type" "bad request", "statuscode" "403" } } 500 (internal server error) { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "bad request", "statuscode" "500" } } 409(upstream down) { "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 help\@signzy com 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!