---
title: "Get on-chain deployment status for account Smart Accounts"
method: GET
path: "/v1/wallets/deployment-status"
tags: ["wallets"]
---

# Get on-chain deployment status for account Smart Accounts

`GET /v1/wallets/deployment-status`

Report on-chain deployment status for the caller's earnings Smart Account and server tipping Smart Account.

Fast path returns the DB-stamped state. If `deployed_at` is NULL the server calls the wallet provider to check bytecode on-chain; if found, the DB row is healed so subsequent reads skip the round-trip.

Response fields:
- `earnings`: `deployed` / `undeployed` / `unknown`
- `server_tipping`: `deployed` / `undeployed` / `unknown`

Errors:
- 401: Missing/invalid bearer token

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Response `200`

Successful Response

- SmartWalletDeploymentStatusResponse — On-chain deployment status for an account's EIP-4337 Smart Accounts. Field names are intentionally short (`earnings`, `server_tipping`) rather than verbose (e.g. `earnings_smart_account_status`). The envelope already scopes the response to Smart Account deployment status, so repeating `_smart_account_status` on every field would be redundant.
  - `earnings` 'deployed' | 'undeployed' | 'unknown', required — Deployment status of the user's earnings Smart Account. - `deployed`: on-chain bytecode present - `undeployed`: SA not yet deployed (client must finish setup) - `unknown`: no earnings SA row on file
  - `server_tipping` 'deployed' | 'undeployed' | 'unknown', required — Deployment status of the server tipping Smart Account. - `deployed`: on-chain bytecode present - `undeployed`: deploy needed (POST /wallets/server-tipping/redeploy) - `unknown`: no server SA row on file (non-EVM or legacy)

## Other responses

- `401` — Missing or invalid bearer token
- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/revisions/f286b48a8105/schema)