---
title: "Poll an agent funding handoff"
method: GET
path: "/credits/agent/funding-sessions/{sessionId}"
tags: ["Agent-native onboarding"]
---

# Poll an agent funding handoff

`GET /credits/agent/funding-sessions/{sessionId}`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/agent/funding-sessions/{sessionId}`
- Auth: HTTP bearer

Returns ready only after the signed Stripe webhook has been durably consumed and the credit ledger balance is usable.

## Path parameters

- `sessionId` string, required

## Response `200`

Current authenticated funding state

- AgentFundingStatus
  - `success` unknown, required
  - `fundingSessionId` string, required
  - `state` 'awaiting_payment' | 'processing' | 'ready' | 'expired' | 'failed', required
  - `paymentStatus` string, required
  - `balance` AgentOwnedBalance, required
    - `usd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `credits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `creditsPerDollar` string, required
  - `nextAction` object, required

## Other responses

- `404`: Session does not belong to this agent account

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)