---
title: "Get partner balance and earnings"
method: GET
path: "/api/partner/balance"
tags: ["Partner"]
---

# Get partner balance and earnings

`GET /api/partner/balance`

## Request

- Base URL: `https://x402-agent-pay.com`
- URL: `https://x402-agent-pay.com/api/partner/balance`
- Auth: none declared

Returns current claimable balance, total earned, payout wallet, and verification status for a partner.

## Query parameters

- `partner_id` string, required
- `api_key` string, required

## Response `200`

Balance data

- PartnerBalance
  - `partner_id` string
  - `claimable_usdc` number
  - `total_earned_usdc` number
  - `payout_wallet` string
  - `payout_verified` boolean
  - `revenue_share_pct` number

## Other responses

- `401`: Invalid api_key

---

[API](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api.md) · [All operations](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/x402-agent-pay/apis/agentpay-x402-facilitator-api/revisions/33ece6814ac9?raw)