Skip to main content
GET
/
v1
/
business
/
registry
/
{registration_jurisdiction}
/
{registration_number}
Get business from registry
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/business/registry/{registration_jurisdiction}/{registration_number}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "palm_id": "1234-5678-9012",
  "name": "Acme Corp",
  "formation_date": "2020-03-15",
  "fictitious_names": [
    "DBA Name LLC"
  ],
  "industry_codes": [
    {
      "code": "541511",
      "type": "naics",
      "description": "Custom Computer Programming Services"
    }
  ],
  "associates": [
    {
      "role": "agent",
      "name": "John Smith",
      "type": "person",
      "title": "Registered Agent",
      "address": {
        "country": "US",
        "street_line_1": "100 Main Street",
        "street_line_2": "Suite 200",
        "city": "San Francisco",
        "region": "CA",
        "postal_code": "94105"
      }
    }
  ],
  "filings": [
    {
      "type": "annual_report",
      "type_name": "Annual Report",
      "title": "Annual Report",
      "filed_date": "2024-01-15",
      "effective_date": "2024-01-15",
      "description": "Annual Report 2024"
    }
  ],
  "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"
  },
  "mailing_address": {
    "country": "US",
    "street_line_1": "100 Main Street",
    "street_line_2": "Suite 200",
    "city": "San Francisco",
    "region": "CA",
    "postal_code": "94105"
  },
  "standing": {
    "registration": "compliant",
    "tax": "compliant",
    "agent": "compliant"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Path Parameters

​
registration_jurisdiction
string
required

Registration jurisdiction (e.g., US-CA, US-DE)

Example:

"US-CA"

​
registration_number
string
required

Secretary of State registration/file number

Example:

"202012345678"

Response

Business details retrieved successfully

​
palm_id
string
required

Unique Palm business identifier

Example:

"1234-5678-9012"

​
name
string
required

Business legal name

Example:

"Acme Corp"

​
formation_date
string
required

Date the business was formed (YYYY-MM-DD)

Example:

"2020-03-15"

​
fictitious_names
string[]
required

List of fictitious/DBA names

Example:
["DBA Name LLC"]
​
industry_codes
object[]
required

Industry classification codes (NAICS, SIC)

​
associates
object[]
required

Officers, directors, agents, and other associates

​
filings
object[]
required

Filing history (amendments, annual reports, etc.)

​
formation_jurisdiction
object

Jurisdiction where the business was originally formed (US-XX format)

Example:

"US-DE"

​
registration_jurisdiction
object

Jurisdiction where the business is registered to operate (US-XX format)

Example:

"US-CA"

​
status
enum<string> | null

Current business status from Secretary of State records

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

"active"

​
entity_type
enum<string> | null

Type of business entity

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

"llc"

​
registration_number
string

Secretary of State registration number

Example:

"202012345678"

​
principal_address
object

Principal place of business address

​
mailing_address
object

Mailing address

​
standing
object

Compliance standing with state agencies