---
title: "Read the Keyban welcome offer"
method: GET
path: "/v1/agent-wallets/sponsor-grant"
tags: ["Agent Wallets"]
---

# Read the Keyban welcome offer

`GET /v1/agent-wallets/sponsor-grant`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/agent-wallets/sponsor-grant`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

The organization's welcome offer: Keyban pays the first x402 payments of the wallet that earned it (`walletId` / `walletAddress`, the organization's first Base agent wallet) until the amount is spent or the offer expires. `null` when the organization never received one.

## Query parameters

- `applicationId` string, uuid, required

## Response `200`

Welcome offer, or `null` when the organization has none

- SponsorGrantDtoOutput, nullable
  - `walletId` string, uuid, required: Agent wallet the offer covers (the first Base agent wallet of the organization); no other wallet is sponsored
  - `walletAddress` string, required: On-chain address of the agent wallet the offer covers
  - `network` 'EthereumAnvil' | 'BaseSepolia' | 'BaseMainnet' | 'XdcApothem' | 'XdcMainnet' | 'StellarQuickstart' | 'StellarTestnet' | 'StellarMainnet', required: Network on which Keyban covers the payments
  - `amount` string, required: Amount offered, in USDC base units (6 decimals)
  - `remaining` string, required: Amount still covered, in USDC base units (6 decimals)
  - `grantedAt` string, date-time, required: When the offer was granted (first Base agent wallet)
  - `expiresAt` string, date-time, required: When what remains stops being covered
  - `status` 'active' | 'exhausted' | 'expired', required: active, exhausted (fully spent) or expired

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)