Search business registries

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'The Coca-Cola Company',
    palm_id: '4604-3477-1850',
    registration_jurisdiction: 'US-FL',
    formation_jurisdiction: 'US-DE',
    location_street: 'One Coca-Cola Plaza NW',
    location_city: 'Atlanta',
    location_region: 'US-GA',
    location_postal_code: '30313',
    entity_type: 'corporation',
    status: 'active',
    formation_date: {from: '2026-03-23', to: '2026-04-22'}
  })
};

fetch('https://api.getpalm.com/v1/business/registry/search', 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/search"

payload = {
    "name": "The Coca-Cola Company",
    "palm_id": "4604-3477-1850",
    "registration_jurisdiction": "US-FL",
    "formation_jurisdiction": "US-DE",
    "location_street": "One Coca-Cola Plaza NW",
    "location_city": "Atlanta",
    "location_region": "US-GA",
    "location_postal_code": "30313",
    "entity_type": "corporation",
    "status": "active",
    "formation_date": {
        "from": "2026-03-23",
        "to": "2026-04-22"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.getpalm.com/v1/business/registry/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "The Coca-Cola Company",
  "palm_id": "4604-3477-1850",
  "registration_jurisdiction": "US-FL",
  "formation_jurisdiction": "US-DE",
  "location_street": "One Coca-Cola Plaza NW",
  "location_city": "Atlanta",
  "location_region": "US-GA",
  "location_postal_code": "30313",
  "entity_type": "corporation",
  "status": "active",
  "formation_date": {
    "from": "2026-03-23",
    "to": "2026-04-22"
  }
}
'

{
  "object": "list",
  "data": [
    {
      "palm_id": "2735-1926-5317",
      "name": "THE COCA-COLA COMPANY",
      "formation_date": "1961-01-03",
      "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"
      }
    }
  ]
}

{
  "type": "https://api.getpalm.com/problems/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "instance": "/business/registry/search",
  "errors": [
    {
      "field": "name",
      "message": "name should not be empty",
      "code": "NOT_EMPTY"
    }
  ]
}

{
  "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"
}

POST

business

registry

Search business registries

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'The Coca-Cola Company',
    palm_id: '4604-3477-1850',
    registration_jurisdiction: 'US-FL',
    formation_jurisdiction: 'US-DE',
    location_street: 'One Coca-Cola Plaza NW',
    location_city: 'Atlanta',
    location_region: 'US-GA',
    location_postal_code: '30313',
    entity_type: 'corporation',
    status: 'active',
    formation_date: {from: '2026-03-23', to: '2026-04-22'}
  })
};

fetch('https://api.getpalm.com/v1/business/registry/search', 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/search"

payload = {
    "name": "The Coca-Cola Company",
    "palm_id": "4604-3477-1850",
    "registration_jurisdiction": "US-FL",
    "formation_jurisdiction": "US-DE",
    "location_street": "One Coca-Cola Plaza NW",
    "location_city": "Atlanta",
    "location_region": "US-GA",
    "location_postal_code": "30313",
    "entity_type": "corporation",
    "status": "active",
    "formation_date": {
        "from": "2026-03-23",
        "to": "2026-04-22"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.getpalm.com/v1/business/registry/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "The Coca-Cola Company",
  "palm_id": "4604-3477-1850",
  "registration_jurisdiction": "US-FL",
  "formation_jurisdiction": "US-DE",
  "location_street": "One Coca-Cola Plaza NW",
  "location_city": "Atlanta",
  "location_region": "US-GA",
  "location_postal_code": "30313",
  "entity_type": "corporation",
  "status": "active",
  "formation_date": {
    "from": "2026-03-23",
    "to": "2026-04-22"
  }
}
'

{
  "object": "list",
  "data": [
    {
      "palm_id": "2735-1926-5317",
      "name": "THE COCA-COLA COMPANY",
      "formation_date": "1961-01-03",
      "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"
      }
    }
  ]
}

{
  "type": "https://api.getpalm.com/problems/validation_error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request validation failed",
  "instance": "/business/registry/search",
  "errors": [
    {
      "field": "name",
      "message": "name should not be empty",
      "code": "NOT_EMPTY"
    }
  ]
}

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

Body

application/json

name

string

Business name to search. Required when neither associate.name nor palm_id is provided.

Example:

"The Coca-Cola Company"

associate

object

Search by an associated person or organization (officer, director, manager, member, or registered agent). Required when neither name nor palm_id is provided.

Show child attributes

palm_id

string

Palm ID of a specific registry business. When provided, returns that record directly without name-based matching.

Example:

"4604-3477-1850"

registration_jurisdiction

string

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

Example:

"US-FL"

formation_jurisdiction

string

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

Example:

"US-DE"

location_street

string

Street address where business is physically located

Example:

"One Coca-Cola Plaza NW"

location_city

string

City where business is physically located

Example:

"Atlanta"

location_region

string

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

Example:

"US-GA"

location_postal_code

string

Postal/ZIP code where business is physically located

Example:

"30313"

entity_type

enum<string>

Entity type

Available options:

corporation,

llc,

lp,

llp,

nonprofit

Example:

"corporation"

status

enum<string>

Business status

Available options:

active,

inactive,

dissolved,

expired,

merged,

withdrawn,

pending,

canceled

Example:

"active"

formation_date

object

Filter by business formation date (inclusive range). Either bound is optional.

Show child attributes

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.

Default
Expanded Result

Show child attributes

Introduction

Get business from registry

⌘I