Skip to main content
GET
List deposits and settlement status
Returns detected deposits for the account. Use it to follow confirmation, settlement, retry or intervention, and completion without re-checking the source transaction. Filter by status (detected, confirming, settling, settled, reversed, failed, ignored, requires_intervention) and page with limit (up to 100, default 50) and cursor. See Depositing funds.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Query Parameters

status
enum<string>
Available options:
detected,
confirming,
settling,
settled,
reversed,
failed,
ignored,
requires_intervention
limit
integer
default:50
Required range: x <= 100
cursor
string

Opaque cursor returned as nextCursor by the previous page.

Response

Deposits

accountId
string
required
Example:

"acct_123"

deposits
object[]
required
nextCursor
string

Pass this value as cursor to fetch the next page.