The company name checker API lets you verify whether a proposed company name is available in one or more US state jurisdictions. Use it before starting an incorporation to reduce the risk of name conflicts.
Authentication Pass your API key in the x-api-key header on every request.
curl --request POST \ --url 'https://api.prod.commenda.io/company-name-checker' \ --header 'x-api-key: <your_api_key>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Acme Corp", "jurisdictions": [ { "level": "STATE_OR_PROVINCE", "country": "US", "code": "DE" } ] }'
Contact the Commenda team to obtain an API key.
Check name availability The company name to check.
One or more jurisdictions to check against. Each object contains: Jurisdiction level. Currently only STATE_OR_PROVINCE is supported.
ISO 3166-1 alpha-2 country code. Currently only US is supported.
Two-letter state or province code (ISO 3166-2), for example DE for Delaware or CA for California.
Request example curl --request POST \ --url 'https://api.prod.commenda.io/company-name-checker' \ --header 'x-api-key: <your_api_key>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Acme Holdings", "jurisdictions": [ { "level": "STATE_OR_PROVINCE", "country": "US", "code": "DE" }, { "level": "STATE_OR_PROVINCE", "country": "US", "code": "CA" } ] }'
Response A successful response returns the queried name and an availability array with one entry per jurisdiction.
{ "name" : "Acme Holdings" , "availability" : [ { "level" : "STATE_OR_PROVINCE" , "country" : "US" , "code" : "DE" , "available" : true , "success" : true , "error" : "" }, { "level" : "STATE_OR_PROVINCE" , "country" : "US" , "code" : "CA" , "available" : false , "success" : true , "error" : "" } ] }
The company name that was checked.
Per-jurisdiction results. The jurisdiction level checked (for example, STATE_OR_PROVINCE).
The country code of the jurisdiction.
The state or province code.
true if no exact-match company name was found in this jurisdiction.
true if the check completed without errors.
Empty on success. Contains an error message if the check failed.
Error responses Status Description 400Unsupported country or invalid jurisdiction code. 401Missing or invalid API key.
When a request-level error occurs, every entry in the availability array returns success: false with an error message:
{ "name" : "Acme Holdings" , "availability" : [ { "level" : "STATE_OR_PROVINCE" , "country" : "US" , "code" : "DE" , "available" : false , "success" : false , "error" : "Unknown error occurred" } ] }
Supported jurisdictions The API currently supports all 50 US states, the District of Columbia, and Puerto Rico.
Full list of supported state codes
Code State ALAlabama AKAlaska AZArizona ARArkansas CACalifornia COColorado CTConnecticut DCDistrict of Columbia DEDelaware FLFlorida GAGeorgia HIHawaii IDIdaho ILIllinois INIndiana IAIowa KSKansas KYKentucky LALouisiana MEMaine MDMaryland MAMassachusetts MIMichigan MNMinnesota MSMississippi MOMissouri MTMontana NENebraska NVNevada NHNew Hampshire NJNew Jersey NMNew Mexico NYNew York NCNorth Carolina NDNorth Dakota OHOhio OKOklahoma OROregon PAPennsylvania PRPuerto Rico RIRhode Island SCSouth Carolina SDSouth Dakota TNTennessee TXTexas UTUtah VTVermont VAVirginia WAWashington WVWest Virginia WIWisconsin WYWyoming
