Company name checker

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

string

required

The company name to check.

array

required

One or more jurisdictions to check against. Each object contains:

Show Jurisdiction object

string

required

Jurisdiction level. Currently only STATE_OR_PROVINCE is supported.

string

required

ISO 3166-1 alpha-2 country code. Currently only US is supported.

string

required

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": ""
    }
  ]
}

string

The company name that was checked.

array

Per-jurisdiction results.

Show Availability object

string

The jurisdiction level checked (for example, STATE_OR_PROVINCE).

string

The country code of the jurisdiction.

string

The state or province code.

boolean

true if no exact-match company name was found in this jurisdiction.

boolean

true if the check completed without errors.

string

Empty on success. Contains an error message if the check failed.

Error responses

Status	Description
`400`	Unsupported country or invalid jurisdiction code.
`401`	Missing 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
`AL`	Alabama
`AK`	Alaska
`AZ`	Arizona
`AR`	Arkansas
`CA`	California
`CO`	Colorado
`CT`	Connecticut
`DC`	District of Columbia
`DE`	Delaware
`FL`	Florida
`GA`	Georgia
`HI`	Hawaii
`ID`	Idaho
`IL`	Illinois
`IN`	Indiana
`IA`	Iowa
`KS`	Kansas
`KY`	Kentucky
`LA`	Louisiana
`ME`	Maine
`MD`	Maryland
`MA`	Massachusetts
`MI`	Michigan
`MN`	Minnesota
`MS`	Mississippi
`MO`	Missouri
`MT`	Montana
`NE`	Nebraska
`NV`	Nevada
`NH`	New Hampshire
`NJ`	New Jersey
`NM`	New Mexico
`NY`	New York
`NC`	North Carolina
`ND`	North Dakota
`OH`	Ohio
`OK`	Oklahoma
`OR`	Oregon
`PA`	Pennsylvania
`PR`	Puerto Rico
`RI`	Rhode Island
`SC`	South Carolina
`SD`	South Dakota
`TN`	Tennessee
`TX`	Texas
`UT`	Utah
`VT`	Vermont
`VA`	Virginia
`WA`	Washington
`WV`	West Virginia
`WI`	Wisconsin
`WY`	Wyoming

Overview

Customer setup

Partner Incorporation API

Commenda OS Partner API

Webhooks

Authentication

Check name availability

Request example

Response

Error responses

Supported jurisdictions

​Authentication

​Check name availability

​Request example

​Response

​Error responses

​Supported jurisdictions

Authentication

Check name availability

Request example

Response

Error responses

Supported jurisdictions