Skip to main content
POST
/
v1
/
business
/
registry
/
search
Search business registries
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Acme Corporation',
    registration_jurisdiction: 'US-CA',
    formation_jurisdiction: 'US-DE',
    ein: '12-3456789',
    location_street: '123 Main Street',
    location_city: 'San Francisco',
    location_region: 'US-CA',
    location_postal_code: '94102',
    entity_type: 'llc',
    status: 'active'
  })
};

fetch('https://api.getpalm.com/v1/business/registry/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "object": "list",
  "data": [
    {
      "palm_id": "1234-5678-9012",
      "name": "Acme Corp",
      "formation_date": "2020-03-15",
      "formation_jurisdiction": "US-DE",
      "registration_jurisdiction": "US-CA",
      "status": "active",
      "entity_type": "llc",
      "registration_number": "202012345678",
      "principal_address": {
        "country": "US",
        "street_line_1": "100 Main Street",
        "street_line_2": "Suite 200",
        "city": "San Francisco",
        "region": "CA",
        "postal_code": "94105"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Body

application/json
​
name
string
required

Business name to search

Example:

"Acme Corporation"

​
registration_jurisdiction
string

Registration jurisdiction in ISO 3166-2 format (e.g., US-CA, US-NY, US-TX)

Example:

"US-CA"

​
formation_jurisdiction
string

Formation jurisdiction in ISO 3166-2 format (e.g., US-DE, US-CA, US-WY)

Example:

"US-DE"

​
ein
string

Employer Identification Number

Example:

"12-3456789"

​
location_street
string

Street address where business is physically located

Example:

"123 Main Street"

​
location_city
string

City where business is physically located

Example:

"San Francisco"

​
location_region
string

Region/state/province where business is physically located (ISO 3166-2 format: XX-YY)

Example:

"US-CA"

​
location_postal_code
string

Postal/ZIP code where business is physically located

Example:

"94102"

​
entity_type
enum<string>

Entity type

Available options:
corporation,
llc,
lp,
llp,
nonprofit
Example:

"llc"

​
status
enum<string>

Business status

Available options:
active,
inactive,
dissolved,
expired,
merged,
withdrawn,
pending,
canceled
Example:

"active"

Response

Search results returned successfully

​
object
string
Example:

"list"

​
data
(Default · object | Expanded Result · object)[]

Response format depends on your account configuration. Contact support@getpalm.com if you have questions.