---
title: "List deposits for an orchestration address"
method: GET
path: "/v2/users/{userId}/orchestration-addresses/{orchestrationAddressId}/deposits"
tags: ["Orchestration Address"]
---

# List deposits for an orchestration address

`GET /v2/users/{userId}/orchestration-addresses/{orchestrationAddressId}/deposits`

## Request

- Base URL: `https://production.hifibridge.com`
- URL: `https://production.hifibridge.com/v2/users/{userId}/orchestration-addresses/{orchestrationAddressId}/deposits`
- Auth: HTTP bearer

List on-chain deposits detected for the address, most recent first.
Filterable by status, batch ID, and a created-at window.

## Path parameters

- `userId` string, required
- `orchestrationAddressId` string, uuid, required

## Query parameters

- `status` 'PENDING' | 'BATCHED' | 'IGNORED' | 'REFUNDED'
- `batchId` string, uuid
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `limit` integer

## Response `200`

A paginated list of deposits for the named orchestration address.

- OrchestrationDepositAllRecordsObject: Paginated list of deposits for an orchestration address.
  - `count` integer
  - `records` OrchestrationDepositObject[]
    - `id` string, uuid: Deterministic UUID derived from `(providerReferenceId, escrowWalletId)`. Stable across webhook re-deliveries.
    - `orchestrationAddressId` string, uuid
    - `batchId` string, uuid, nullable: ID of the batch that included this deposit. `null` while `status=PENDING` or `status=IGNORED`.
    - `amount` string: Decimal amount of the source token deposited (e.g. `"100.500000"`). Precision matches the token's on-chain decimals.
    - `currency` 'usdc' | 'usdt'
    - `chain` string: Abbreviated chain name (e.g. `BASE`).
    - `sourceAddress` string: On-chain address that sent the deposit. Informational only.
    - `transactionHash` string: On-chain transaction hash.
    - `status` 'PENDING' | 'BATCHED' | 'IGNORED' | 'REFUNDED': Per-deposit status. * `PENDING` — recorded, waiting to be rolled into a batch. * `BATCHED` — included in a batch (`batchId` is set). * `IGNORED` — recorded but never batched. See `ignoredReason` for why. * `REFUNDED` — was `PENDING` when the address was deactivated; the funds were refunded in-kind to the `walletAddress` supplied at deactivation.
    - `ignoredReason` 'ADDRESS_DEACTIVATED' | 'UNSUPPORTED_TOKEN': Why a deposit was ignored. Funds remain in the escrow wallet — a Slack alert fires for manual ops follow-up. * `ADDRESS_DEACTIVATED` — the deposit arrived after the address was deactivated. * `UNSUPPORTED_TOKEN` — the deposited token does not match the address's configured `source.currency` (e.g. USDT sent to a USDC-only address).
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `nextCursor` string, date-time, nullable: Pass this value as `createdBefore` to retrieve the next page. `null` means no next page is advertised.

## Other responses

- `401`: Unauthorized
- `404`: Resource not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/hifi/apis/hifi-api.md) - [All operations](https://skmtc.dev/hifi/apis/hifi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hifi/apis/hifi-api/revisions/319fa6bd5bc6?raw)