> ## Documentation Index > Fetch the complete documentation index at: https://docs.getpalm.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](mailto:support@getpalm.com) 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". ## OpenAPI ````yaml /api-reference/v1/openapi.json get /v1/business/{business_id}/registered-agent openapi: 3.0.0 info: title: Palm Partner API description: >- The Palm API is identity verification and compliance infrastructure for US businesses: onboard businesses, verify businesses and people (KYB/KYC) against authoritative sources, monitor them for changes in real time, and act on their behalf through filings, formation, and registered agent services. version: '1.0' contact: name: Palm Support url: https://getpalm.com email: support@getpalm.com termsOfService: https://getpalm.com/terms license: name: Proprietary url: https://getpalm.com/license servers: - url: https://api.getpalm.com description: Production security: [] tags: - name: Registry description: Search business registries - name: Verification description: Identity and business verification - name: Monitor description: Continuous monitoring of businesses - name: Business description: Business entity management - name: User description: User identity management paths: /v1/business/{business_id}/registered-agent: get: tags: - Registered Agent summary: Retrieve registered agent service description: >- > **⚠️ 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](mailto:support@getpalm.com) 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". operationId: getRegisteredAgent parameters: - name: business_id required: true in: path schema: type: string responses: '200': description: Registered agent service snapshot content: application/json: schema: $ref: '#/components/schemas/RegisteredAgent' '404': description: Palm is not the registered agent for this business security: - ApiKey: [] components: schemas: RegisteredAgent: type: object properties: object: type: string description: Object type identifier, always "registered_agent" enum: - registered_agent example: registered_agent business_id: type: string description: Business this RA-service state belongs to format: uuid example: 987e6543-e21a-45b6-c789-012345678901 provider: type: string description: >- Who provides RA service. `palm` when Palm provides service, `external` when the partner uses a different RA, `null` when no RA is tracked. enum: - palm - external nullable: true example: palm status: type: string description: >- Lifecycle status of Palm-provided RA service. `null` when the partner uses an external RA or has never used Palm RA. enum: - pending - active - termination_requested - terminated - failed nullable: true example: active jurisdiction: type: string description: Jurisdiction (state) the RA service is for nullable: true example: CA started_at: type: string description: ISO 8601 timestamp when the current service window started format: date-time nullable: true example: '2026-05-29T10:30:00Z' ended_at: type: string description: >- ISO 8601 timestamp when the most recent service window ended (null while active) format: date-time nullable: true example: null rejection_reason: type: string description: >- 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. nullable: true example: >- State refused resignation form: GA requires a successor RA designation name: type: string description: >- 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. nullable: true example: Acme Registered Agent Services, Inc. address: description: >- 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. nullable: true type: object allOf: - $ref: '#/components/schemas/Address' required: - object - business_id - provider - status - jurisdiction - started_at - ended_at Address: type: object properties: street_line_1: type: string example: One Coca-Cola Plaza NW description: Street address line 1 street_line_2: type: string example: Suite 200 description: Street address line 2 (apt, suite, etc.) city: type: string example: Atlanta description: City region: type: string example: GA description: State or region code postal_code: type: string example: '30313' description: Postal/ZIP code country: type: string example: US description: Country code required: - country securitySchemes: ApiKey: scheme: bearer bearerFormat: opaque type: http description: 'Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx' ````