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

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

required

Portfolio business ID

Example:

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

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,

canceled

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

Why the service did not proceed. Carries the rejection reason on the registered_agent.failed, registered_agent.change_failed, and registered_agent.termination_failed webhook payloads, and the cancellation reason on registered_agent.canceled. Null on every other event and on reads of the resource.

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 and the agent has been assigned; null otherwise.

Example:

"Acme Registered Agent Services, Inc."

address

object | null

Mailing address of the registered agent of record. Populated when Palm provides RA service and the agent has been assigned; null otherwise.

Show child attributes

Palm Introduction

API Introduction

Endpoints

Retrieve registered agent service

Authorizations

Path Parameters

Response