---
title: "Check whether there is an open onramp event awaiting transfer"
method: GET
path: "/v1/onramp/pending-transfer"
tags: ["onramp"]
---

# Check whether there is an open onramp event awaiting transfer

`GET /v1/onramp/pending-transfer`

Check if the authenticated user has an open (unconsumed) onramp event.

The frontend polls this endpoint after the user returns from the Coinbase onramp UI
to determine whether a SA→tipping transfer is needed.

**Parameters:**
- `event_id` (optional): When provided, returns only the specified event (event-scoped).
  When omitted, falls back to the latest open event for the account.

**Response:**
- `pending=true` with event details when there is an actionable event
- `pending=false` when no open events exist

**Polling pattern:** Frontend polls every ~5 seconds after onramp redirect return.

## Query parameters

- `event_id` string, nullable — Specific onramp event ID to check. When omitted, returns the latest open event.

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove.

## Response `200`

Successful Response

- OnrampPendingTransferResponse — Response model for GET /v1/onramp/pending-transfer.
  - `pending` boolean, required — Whether there is an open onramp event
  - `event_id` string, nullable — Onramp event ID
  - `status` string, nullable — Event status
  - `settled_amount` string, nullable — Settled amount to transfer from Smart Account
  - `requested_amount` string, nullable — Originally requested onramp amount
  - `network` string, nullable — Network (e.g., base, base-sepolia)
  - `token` string, nullable — Token symbol (e.g., USDC)
  - `created_at` string, nullable — When event was created (ISO 8601)
  - `consumed` boolean — Whether this event was already consumed
  - `lifecycle_state` string, nullable — Structured lifecycle state: awaiting_coinbase_completion, settlement_detected, transfer_submitted, needs_attention

## Other responses

- `401` — Missing or invalid JWT
- `404` — Event not found or does not belong to this account
- `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/versions/f286b48a8105/schema)