List deposits

Return the on-chain deposits observed for your organization, newest first. Every row is a payment made on chain: who sent it, how much, in which token, and the transaction that carried it. A deposit shows up here shortly after its transaction is mined. A `pending` deposit has been queued for balance crediting, `completed` is reserved for a downstream acknowledgement, and `failed` means the deposited asset is not supported. You only ever see your own organization's deposits.

GET
/payments/deposits

Authorization

AuthorizationBearer <token>

The access token returned after a successful sign-in, sent as Authorization: Bearer <access_token>.

It identifies the person and the organization they are working in, and it lasts about fifteen minutes. When it runs out, use their refresh token at POST /auth/refresh-token instead of asking them to sign in again.

In: header

Query Parameters

id?string

Return only the resource with this identifier. Equivalent to fetching it by path, but usable together with the other list filters.

org_id?string

Return only resources associated with this organization. On protected endpoints, authorization may restrict or replace this value with the credential's active organization.

limit?integer

How many items to return in one page. The default and the maximum are both 25; a larger value is rejected with 400.

Default25
Formatint64
Range1 <= value <= 25
next?string

Cursor for the next page, taken verbatim from the next field of the previous response. Keep every other query parameter the same between pages: sortBy and order are part of what the cursor means. An absent or empty next in a response means there are no more pages.

The value is opaque. Do not parse it or build one yourself.

order?string

Sort direction. Defaults to desc, newest first.

Default"desc"
Value in"asc" | "desc"
sortBy?string

Field used to sort the result. Supported fields depend on the endpoint; use when_created for chronological ordering where it is available. The default is the resource identifier, and identifiers break ties so cursor paging stays stable.

tx_hash?string

Return only the deposit made by this transaction.

token?string

Return only deposits of this token.

Value in"dual"
token_address?string

Return only deposits of the token at this contract address.

status?string

Return only deposits in this state.

Value in"pending" | "completed" | "failed"
when_created[$gt]?string

Indexed strictly after this instant.

Formatdate-time
when_created[$gte]?string

Indexed at or after this instant.

Formatdate-time
when_created[$lt]?string

Indexed strictly before this instant.

Formatdate-time
when_created[$lte]?string

Indexed at or before this instant.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.dual.network/payments/deposits"
{
  "deposits": [
    {
      "id": "665f1c2d4b1a2c3d4e5f6d01",
      "org_id": "665f1c2d4b1a2c3d4e5f6aa0",
      "sender": "0x1234567890abcdef1234567890abcdef12345678",
      "amount": "250000000000000000000",
      "token": "dual",
      "token_address": "0x2222222222222222222222222222222222222222",
      "network": "dual",
      "tx_hash": "0xf1e2d3c4b5a697887766554433221100ffeeddccbbaa99887766554433221100",
      "block_num": 24518903,
      "status": "pending",
      "when_created": "2026-03-01T10:15:00Z",
      "when_modified": "2026-03-01T10:15:04Z"
    }
  ]
}
{
  "code": 3,
  "message": "Key: 'limit' Error:Field validation for 'limit' failed on the 'lte' tag"
}

{
  "code": 16,
  "message": "no auth provided"
}

{
  "code": 13,
  "message": "internal error"
}