---
title: "Embedder Me Balance"
method: GET
path: "/v1/embedders/me/balance"
tags: ["embedders"]
---

# Embedder Me Balance

`GET /v1/embedders/me/balance`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/embedders/me/balance`
- Auth: none declared

Return the calling embedder's live custody balance.

Powers the FE PR #275 Claim-portal balance card.

Zero-state graceful: if no ``EmbedderBalance`` row exists yet (no
revenue has landed for this embedder), surface a fully-zero shape
instead of 404. The FE renders "$0.00 claimable" + "wallet
provisioning" copy from the same shape.

``claimable = accrued - withdrawn``. Computed at read-time so a
pending withdrawal in 'pending'/'processing' status (which hasn't
yet bumped ``withdrawn_usdc_micros``) is reflected as still-claimable.
The Claim button on the FE separately disables itself if there's an
in-flight withdrawal (that check uses /withdrawals, not /balance).

## Response `200`

Successful Response

- object

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)
