Business Verification US - Document Fetch

overview & purpose the business verification api offers 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 it's important to highlight that the greater the amount of detailed information a client provides about their business, the more confidence signzy will have in the generated report signzy upholds stringent data quality standards and adheres to principles of data completeness, accuracy, and timeliness after creating a business, signzy immediately begins searching for business records based on the information provided once a business is created and signzy returns results, the business review tasks will highlight insights about the data to easily decisions and automate the results key capabilities the business verification helps to retrieve the core details about any registered business entity the package bundles together the following reports report description name / tin verification verifies that the submitted business name and tax id combination match secretary of state filing retrieval searches all 50 secretary of states and d c to uncover state registrations and the "footprint" of a business based on state availability, each record may provide a rich dataset including entity name, registration date, entity type, registered addresses, and corporate officers detailed address analysis aggregates all known addresses retrieved from both state filings and web presence, displaying them with both street and satellite images assesses deliverability and type (eg, p o box, commercial, residential) of each address business names collection of all developed business names linked to a business with a matching of the submitted name officers all listed officers found in the business secretary of state filings with associated roles web presence / validation searches for business across popular search engines to display the most relevant results and all social profiles validates submitted web addresses to extract relevant business details consolidated ofac screening searches government watchlists to determine business sanctions status, applying advanced matching logic to reduce false positives profiles searches for the business on various websites to find the company's online presence currently, only facebook and google places are supported tasks a detailed summary of all searches, flagging risk factors based on results across screenings and developed entity information the integrated capabilities of the api provide a robust solution for managing business information in the united states the business 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, and 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 business verification api api input curl location 'https //api preproduction signzy us/api/v3/us kyb/business verification us' \\ \ header 'accept application/json' \\ \ header 'content type application/json' \\ \ header 'authorization < 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" "< url >", "callbackurl" "< url >", "products" \[ "businessverificationverify", "tin", "website", "documents", "uccliens", "taxliens", "bankruptcies", "litigations", "businessreport" ], "subproducts" \[ "articlesofincorporation", "certificateofgoodstanding", "uccdocuments" ] }'curl location 'https //api signzy us/api/v3/us kyb/business verification us' \\ \ header 'accept application/json' \\ \ header 'content type application/json' \\ \ header 'authorization < 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" "< url >", "callbackurl" "< url >", "products" \[ "businessverificationverify", "tin", "website", "documents", "uccliens", "taxliens", "bankruptcies", "litigations", "businessreport" ], "subproducts" \[ "articlesofincorporation", "certificateofgoodstanding", "uccdocuments" ] }' api input mapping field type required/optional description name string required name of the company addressline1 string required address line one of the company addressline2 string optional address line two of the company city string required city the office is located(can be any branch of the company registered with govt ) state string required two state of where the office is located(can be any branch of the company registered with govt ) postalcode string required postal code of the office located tin string optional a unique 9 digit number that is used by the irs to identify a business entity must be passed in order to conduct tin verification formationstate string optional two letter abbreviation for the state the business was formed in entitytype string optional the entity type of the business one of " corporation ", " llc ", " partnership ", " non profit ", " trust ", or " sole proprietorship " websiteurl string optional official website of the company callbackurl string optional webhook url link to send the response back orders string optional array of vendor's orders product string optional type of product ordered the type of product to be ordered this can be tin, businessverificationverify, documents, uccliens, taxliens, litigations, bankruptcies, website, businessreport subproducts object optional type of product ordered the subproducts must be part of the products entered this could be articleofincorporation, certificateofgoodstanding for documents , uccdocuments for uccleins subproducts information subproduct parameters should mandatorily have associated product parameters with them in the input body we have mentioned the products and associated subproducts below these subproducts could be availed only if the associated products are mentioned in input body product subproducts documents article of incorporation, certificate of good standing uccleins uccdocuments business report generation time (business report) it can take up to 30 min to 4 hrs to generate a business report we recommend providing the webhook in the input parameter so that when the complete response is ready it will be posted in the webhook automatically meanwhile, the intermittent response will be available in the retrieve business api api output 200 { "result" { "object" "business", "businessid" "0a23262 1a24 43f8 a437 43e45h67d5", "name" "energy transfer lp", "status" "in audit", "documents" \[ { "object" "document", "id" "69fec8ac ba94 400d 9e08 c45a1dec667e", "document type" "certificate of good standing", "filename" "2417015 certificate of good standing 2023 12 14", "content type" "application/pdf", "size" 48639, "download url" "https //persist signzy tech/api/files/825231903/download/96d7decb7e55450f77af pdf", "created at" "2023 12 14t18 19 05 877z", "source" { "type" "registration", "id" "66709958 f3d2 41a3 aa7a 145c3c62fcbb", "metadata" { "state" "de", "status" "unknown" } }, "filing date" "2023 12 14t00 00 00 000z", "metadata" {} } ], "businessreport" { "businessreport" "https //persist signzy tech/api/files/825231903/download/96d7decb7f pdf" }, "names" \[ { "object" "name", "id" "2a63cc2a 682b 482e 8a72 5d0a1ae79926", "name" "energy transfer lp", "submitted" true, "type" "legal", "business id" "0a23262 1a24 43f8 a437 43e45h67d5", "sources" \[ { "id" "ac0dc5a4 5535 42c2 8493 228c0c477c24", "type" "profile", "metadata" { "url" "https //maps google com/?cid=16334286033772247593", "name" "energy transfer partners", "type" "google", "website" "http //www energytransfer com/contact us aspx?t=1", "latitude" 32 8614329, "longitude" 96 80702769999999, "categories" \[ "point of interest", "establishment" ], "full address" "8111 westchester dr, dallas, tx 75225, usa", "phone number" "(214) 981 0700" } }, { "id" "e8d848de 7bd6 49df ad05 fcb15573b950", "type" "registration", "metadata" { "state" "de", "status" "unknown", "file number" "7098149", "jurisdiction" "domestic" } }, ] } ], "addresses" \[ { "object" "address", "address line1" "8111 westchester dr", "address line2" null, "city" "dallas", "state" "tx", "postal code" "75225 6140", "full address" "8111 westchester dr, dallas, tx 75225 6140", "submitted" true, "id" "c7adc203 3715 4bc0 9c2d 4b8ffa3c34df", "latitude" 32 86153315483361, "longitude" 96 80653328836787, "property type" "commercial", "deliverable" true, "deliverability analysis" null, "street view available" true, "labels" \[], "created at" "2024 02 12t18 31 10 787z", "updated at" "2024 02 12t18 31 11 595z", "registered agent name" null, "cmra" false, "business id" "0a23d662 1a14 48e8 a617 43e49dba96d5", "sources" \[ { "id" "ac0dc5a4 5535 42c2 8493 228c0c477c24", "type" "profile", "metadata" { "url" "https //maps google com/?cid=16334286033772247593", "name" "energy transfer partners", "type" "google", "website" "http //www energytransfer com/contact us aspx?t=1", "latitude" 32 8614329, "longitude" 96 80702769999999, "categories" \[ "point of interest", "establishment" ], "full address" "8111 westchester dr, dallas, tx 75225, usa", "phone number" "(214) 981 0700" } }, "tags" \[], "assigneeid" "54e1a78f 8ab4 49f7 ad62 f75000832b72", "supporteddocumenttypes" \[ "certificate of good standing" ], "review" { "object" "review", "id" "599154c9 f0fb 41c7 b751 d04cc39d5d20", "created at" "2024 02 12t18 31 11 436z", "updated at" "2024 02 12t18 31 11 436z", "completed at" null, "tasks" \[ { "category" "name", "key" "name and entity type", "label" "name entity type", "message" "the submitted business name and entity type do not match the registration name", "name" "name", "status" "failure", "sub label" "unverified", "sources" \[] }, { "category" "litigations", "key" "litigations", "label" "litigations", "message" "the business has 10 related litigations", "name" "litigations", "status" "failure", "sub label" "found", "sources" \[] }, }, "tin" { "name" "energy transfer lp", "mismatch" false, "unknown" false, "verified" true, "error" null, "updated at" "2024 02 12t18 31 13 923z", "issued" null, "business id" "0a23d662 1a14 48e8 a617 43e49dba96d5", "tin" "30 0108820" }, "businessbatchid" "", "formation" { "entity type" "partnership", "formation date" "2005 08 23", "formation state" "de", "created at" "2024 02 12t18 31 13 018z", "updated at" "2024 02 12t18 31 13 018z" }, "watchlist" { "object" "watchlist", "id" "5a2e28c4 93d0 4110 b87c efd8e9656658", "hit count" 0, "agencies" \[ { "abbr" "ofac", "name" "office of foreign assets control", "org" "u s department of treasury" }, { "abbr" "bis", "name" "bureau of industry and security", "org" "u s department of commerce" }, { "abbr" "ddtc", "name" "directorate of defense trade controls", "org" "u s department of state" }, { "abbr" "isn", "name" "bureau of international security and non proliferation", "org" "u s department of state" } ], "lists" \[ { "object" "watchlist source", "agency" "office of foreign assets control", "agency abbr" "ofac", "organization" "u s department of treasury", "title" "capta list", "abbr" "cap", "results" \[] }, ], "people" \[ { "object" "person", "name" "sxl acquisition sub llc", "submitted" false, "business id" "0a23d662 1a14 48e8 a617 43e49dba96d5", "sources" \[ { "id" "673c6623 776d 4338 b0ed a630beb81c81", "type" "registration", "metadata" { "state" "ky", "status" "inactive", "file number" "0709720", "jurisdiction" "foreign" } } ], "titles" \[ { "object" "person title", "title" "general partner" } ], "people bankruptcies" \[] }, ] }, "bankruptcies" \[], "liens" \[ { "object" "lien", "type" "ucc", "id" "45ca9ca7 a902 40d8 a679 13ee5cda515a", "business id" "0a23d662 1a14 48e8 a617 43e49dba96d5", "debtors" \[ { "name" "seleeker thompson", "addresses" \[ { "city" "malakoff", "state" "tx", "country" "usa", "postal code" "75148", "full address" "p o box 363, malakoff, tx 75148", "address line1" "p o box 363" } ] }, ], "file number" "160006255267", "state" "tx", "status" "closed", "filing date" "2016 02 26", "updated date" "2016 02 26", "lapse date" "2021 02 26", "collateral" null, "collateral type" null, "negative pledge" false, "confirmation number" null, "loan principal amount cents" null, "source" "https //direct sos state tx us/home/home ucc asp", "packet number" null, "lien termination" null, "liability cents" null, "alternative designation" null, "status category" "closed", "documents" \[] }, ], "phonenumbers" \[], "profiles" \[ { "object" "profile", "id" "ac0dc5a4 5535 42c2 8493 228c0c477c24", "type" "google", "external id" "chijt rv0setoyrkxqe3pokr i", "url" "https //maps google com/?cid=16334286033772247593", "metadata" { "full address" "8111 westchester dr, dallas, tx 75225, usa", "name" "energy transfer partners", "website" "http //www energytransfer com/contact us aspx?t=1", "latitude" 32 8614329, "longitude" 96 80702769999999, "phone number" "(214) 981 0700", "categories" \[ "point of interest", "establishment" ] } } ], "registrations" \[ { "object" "registration", "id" "e8d848de 7bd6 49df ad05 fcb15573b950", "business id" "0a23d662 1a14 48e8 a617 43e49dba96d5", "name" "energy transfer lp", "status" "unknown", "sub status" null, "status details" null, "jurisdiction" "domestic", "entity type" "unknown", "file number" "7098149", "addresses" \[ "8111 westchester dr, dallas, tx 75225 6140" ], "officers" \[], "registered agent" { "name" "energy transfer equity, l p " }, "registration date" "2018 10 19", "state" "de", "source" "https //icis corp delaware gov/ecorp/entitysearch/namesearch aspx" }, ], "industryclassification" "", "fmcsaregistrations" \[], "litigations" \[ { "object" "litigation", "id" "bdb41019 006f 4fab 8143 ad42f2984d42", "case name" "energy transfer, lp v greenpeace international", "case number" "2024 cab 000242", "case status" "closed", "case type" "administrative procedure act", "filing date" "2024 01 12", "judgments" \[], "jurisdiction" "superior court of district of columbia", "party type" "plaintiff" }, ], "actions" \[], "policyresults" \[], "submitted" { "object" "submitted attributes", "name" "energy transfer lp", "entity type" "non profit", "addresses" \[ { "city" "dallas", "state" "tx", "postal code" "92882", "address line1" "energy transfer", "address line2" "8111 westchester drive" } ], "orders" \[ { "package" "business verification verify", "product" "business verification verify" }, { "package" "tin", "product" "tin" }, { "package" "documents", "product" "documents", "subproducts" \[] }, { "package" "ucc liens", "product" "ucc liens", "subproducts" \[] }, { "package" "tax liens", "product" "tax liens" }, { "package" "bankruptcies", "product" "bankruptcies" }, { "package" "litigations", "product" "litigations" } ], "people" \[], "phone numbers" null, "tags" null, "external id" null, "unique external id" null, "tin" { "tin" "300108820" }, "website" null, "assignee id" null, "formation" { "entity type" "non profit", "formation state" "tx" }, "names" null } } } 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 documents object information about the documents retrieved and pdf links to them are available in this object businessreport object a business has a pdf representation that is available for download names object details about the business names has objects explaining name, address, jurisdiction, etc addresses object gives response for the addresses associated with the company entered supporteddocumenttypes object this will specify the document types available for retrieval for this particular business the valid values are articles of incorporation and certificate of good standing review object things that are in review about the business that has been searched for tin object information about the employer identification number guaranteed if tin provided when creating the business null if no tin was provided formation object information about the formation of the business the entity type of the business one of "corporation" , "llc" , "partnership" , "non profit" , "trust" , or "sole proprietorship " watchlist object contains information about watchlist screenings related to the company hit counts, agencies, org, and sources are a few among the information retrieved people object information about the important people related to the company and the positions they hold is revealed liens object liens info is searched for a business, which will return ucc1, ucc3, and federal tax filing information for all liens currently associated with that business if the liens parameter is passed phonenumbers object information about the phone numbers associated with the company is provided if available profile object profiles are derived from websites but also matched from web presence types of profiles today include google places and facebook pages registrations object registrations related to the company industryclassifications object objects represent the industry classification of a business fmcsaregistrations object registrations related to federal motor carrier safety administration litigations object litigation would return details on legal cases associated with that business actions object actions associated wiht the company submitted string confirms 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/business verification retrieve us' \\ \ header 'content type application/json' \\ \ header 'authorization < auth token >' \\ \ data '{ "businessid" "b0fesdb3 a2dsfd 4esd0 bscc c1c7fsdff01a" }'curl location 'https //api signzy us/api/v3/us kyb/business verification retrieve us' \\ \ header 'content type application/json' \\ \ header 'authorization < auth token >' \\ \ data '{ "businessid" "b0fesdb3 a2dsfd 4esd0 bscc c1c7fsdff01a" }' api input mapping field type required/optional description businessid string required the id number which helps us retrieve company information this api serves as a fallback option for users encountering difficulties retrieving information through the business verification api typically, users can access comprehensive details about a queried business directly via the business verification api however, in instances where this direct retrieval is unsuccessful, this api acts as a backup solution it ensures that users can still obtain relevant information about the specified business, even without providing a callback url for receiving the response essentially, it offers a fail safe mechanism, ensuring users have access to vital business data when encountering retrieval challenges through the primary api the output for this api is the same as the primary api 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" "forbidden", "statuscode" "403" } } 404 (not found) { "error" { "name" "error", "message" "data not found for the given input", "status" 404, "reason" "error", "type" "not found", "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!