Retrieve registered agent service

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/business/{business_id}/registered-agent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/business/{business_id}/registered-agent"

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

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

print(response.text)

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

{
  "object": "registered_agent",
  "business_id": "987e6543-e21a-45b6-c789-012345678901",
  "provider": "palm",
  "status": "active",
  "jurisdiction": "CA",
  "started_at": "2026-05-29T10:30:00Z",
  "ended_at": null,
  "rejection_reason": "State refused resignation form: GA requires a successor RA designation",
  "name": "Acme Registered Agent Services, Inc.",
  "address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  }
}

Registered Agent

Retrieve registered agent service

⚠️ Early access — This endpoint is in preview and may change in backwards-incompatible ways before it is marked stable. Avoid depending on it in production, and reach out before building on it.

Returns the current snapshot of the registered agent service on a business — provider, status, jurisdiction, and the current service window. Returns 404 when Palm has never been the registered agent for the business; once the service has ended it returns 200 with status: terminated — letting you tell “not your registered agent” apart from “service ended”.

GET

business

{business_id}

registered-agent

Retrieve registered agent service

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/business/{business_id}/registered-agent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getpalm.com/v1/business/{business_id}/registered-agent"

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

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

print(response.text)

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

{
  "object": "registered_agent",
  "business_id": "987e6543-e21a-45b6-c789-012345678901",
  "provider": "palm",
  "status": "active",
  "jurisdiction": "CA",
  "started_at": "2026-05-29T10:30:00Z",
  "ended_at": null,
  "rejection_reason": "State refused resignation form: GA requires a successor RA designation",
  "name": "Acme Registered Agent Services, Inc.",
  "address": {
    "country": "US",
    "street_line_1": "One Coca-Cola Plaza NW",
    "street_line_2": "Suite 200",
    "city": "Atlanta",
    "region": "GA",
    "postal_code": "30313"
  }
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Path Parameters

business_id

string

required

Response

Registered agent service snapshot

object

enum<string>

required

Object type identifier, always "registered_agent"

Available options:

registered_agent

Example:

"registered_agent"

business_id

string<uuid>

required

Business this RA-service state belongs to

Example:

"987e6543-e21a-45b6-c789-012345678901"

provider

enum<string> | null

required

Who provides RA service. palm when Palm provides service, external when the partner uses a different RA, null when no RA is tracked.

Available options:

palm,

external

Example:

"palm"

status

enum<string> | null

required

Lifecycle status of Palm-provided RA service. null when the partner uses an external RA or has never used Palm RA.

Available options:

pending,

active,

termination_requested,

terminated,

failed

Example:

"active"

jurisdiction

string | null

required

Jurisdiction (state) the RA service is for

Example:

"CA"

started_at

string<date-time> | null

required

ISO 8601 timestamp when the current service window started

Example:

"2026-05-29T10:30:00Z"

ended_at

string<date-time> | null

required

ISO 8601 timestamp when the most recent service window ended (null while active)

Example:

null

rejection_reason

string | null

Reason the most recent termination request was rejected by ops. Present only on the registered_agent.termination_failed webhook payload — null on every other event and on reads of the resource. After a rejection the business is back in active and the partner can re-submit a new termination request.

Example:

"State refused resignation form: GA requires a successor RA designation"

name

string | null

Name of the registered agent of record for the business in this jurisdiction. Populated when Palm provides RA service; null when not yet known or the partner uses an external RA.

Example:

"Acme Registered Agent Services, Inc."

address

object | null

Mailing address of the registered agent of record. Populated when Palm provides RA service; null when not yet known or the partner uses an external RA.

Show child attributes

Get formation requirements

Change or end registered agent service

⌘I