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));

import requests

url = "https://api.getpalm.com/v1/business/registry/{registration_jurisdiction}/{registration_number}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.getpalm.com/v1/business/registry/{registration_jurisdiction}/{registration_number} \
  --header 'Authorization: Bearer <token>'

{
  "palm_id": "2735-1926-5317",
  "name": "THE COCA-COLA COMPANY",
  "formation_date": "1961-01-03",
  "fictitious_names": [],
  "industry_codes": [
    {
      "code": "312111",
      "type": "naics",
      "description": "Soft Drink Manufacturing"
    }
  ],
  "associates": [
    {
      "role": "agent",
      "name": "CT Corporation System",
      "type": "organization",
      "title": "Registered Agent",
      "address": {
        "country": "US",
        "street_line_1": "One Coca-Cola Plaza NW",
        "street_line_2": "Suite 200",
        "city": "Atlanta",
        "region": "GA",
        "postal_code": "30313"
      }
    }
  ],
  "formation_jurisdiction": "US-DE",
  "registration_jurisdiction": "US-FL",
  "status": "active",
  "entity_type": "corporation",
  "registration_number": "814956",
  "principal_address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  },
  "mailing_address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  },
  "identifier": {
    "lei": "UWJKFUJFZ02DKWI3RY53",
    "sec_cik": "0000141617",
    "business_number": "774955926RC0001",
    "state_tax_id": "32005739365",
    "duns": "150483782",
    "vat": "GB123456789"
  },
  "standing": {
    "registration": "compliant",
    "tax": "compliant",
    "agent": "compliant"
  }
}

{
  "type": "https://api.getpalm.com/problems/authentication_error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "No valid authentication provided. Please provide one of the accepted authentication methods.",
  "instance": "/business/registry/search"
}

{
  "type": "https://api.getpalm.com/problems/rate_limit_exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 60 seconds.",
  "instance": "/business/registry/search",
  "retry_after": 60,
  "limit": 100000,
  "remaining": 0,
  "reset": 1738540800
}

{
  "type": "https://api.getpalm.com/problems/internal_error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An internal server error occurred. Please contact support if this persists.",
  "instance": "/business/registry/search"
}

GET

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));

import requests

url = "https://api.getpalm.com/v1/business/registry/{registration_jurisdiction}/{registration_number}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.getpalm.com/v1/business/registry/{registration_jurisdiction}/{registration_number} \
  --header 'Authorization: Bearer <token>'

{
  "palm_id": "2735-1926-5317",
  "name": "THE COCA-COLA COMPANY",
  "formation_date": "1961-01-03",
  "fictitious_names": [],
  "industry_codes": [
    {
      "code": "312111",
      "type": "naics",
      "description": "Soft Drink Manufacturing"
    }
  ],
  "associates": [
    {
      "role": "agent",
      "name": "CT Corporation System",
      "type": "organization",
      "title": "Registered Agent",
      "address": {
        "country": "US",
        "street_line_1": "One Coca-Cola Plaza NW",
        "street_line_2": "Suite 200",
        "city": "Atlanta",
        "region": "GA",
        "postal_code": "30313"
      }
    }
  ],
  "formation_jurisdiction": "US-DE",
  "registration_jurisdiction": "US-FL",
  "status": "active",
  "entity_type": "corporation",
  "registration_number": "814956",
  "principal_address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  },
  "mailing_address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  },
  "identifier": {
    "lei": "UWJKFUJFZ02DKWI3RY53",
    "sec_cik": "0000141617",
    "business_number": "774955926RC0001",
    "state_tax_id": "32005739365",
    "duns": "150483782",
    "vat": "GB123456789"
  },
  "standing": {
    "registration": "compliant",
    "tax": "compliant",
    "agent": "compliant"
  }
}

{
  "type": "https://api.getpalm.com/problems/authentication_error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "No valid authentication provided. Please provide one of the accepted authentication methods.",
  "instance": "/business/registry/search"
}

{
  "type": "https://api.getpalm.com/problems/rate_limit_exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 60 seconds.",
  "instance": "/business/registry/search",
  "retry_after": 60,
  "limit": 100000,
  "remaining": 0,
  "reset": 1738540800
}

{
  "type": "https://api.getpalm.com/problems/internal_error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An internal server error occurred. Please contact support if this persists.",
  "instance": "/business/registry/search"
}

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-FL"

registration_number

string

required

Registry-assigned registration/file number

Example:

"814956"

Response

Business details retrieved successfully

palm_id

string

required

Unique Palm business identifier

Example:

"2735-1926-5317"

name

string | null

required

Business legal name

Example:

"THE COCA-COLA COMPANY"

formation_date

string<date> | null

required

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

Example:

"1961-01-03"

fictitious_names

string[]

required

List of fictitious/DBA names

Example:

[]

industry_codes

object[]

required

Industry classification codes (NAICS, SIC)

Show child attributes

associates

object[]

required

Officers, directors, agents, and other associates

Show child attributes

formation_jurisdiction

string | null

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

Example:

"US-DE"

registration_jurisdiction

string | null

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

Example:

"US-FL"

status

enum<string> | null

Current business status from the registry record

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:

"corporation"

registration_number

string

Registry-assigned registration/file number

Example:

"814956"

principal_address

object

Principal place of business address

Show child attributes

mailing_address

object

Mailing address

Show child attributes

identifier

object

Additional public, cross-registry identifiers. Only identifiers present on the record are included.

Show child attributes

standing

object

Compliance standing with state agencies

Show child attributes

Search business registries

Check business name eligibility

⌘I