---
title: "Get an agent deposit"
method: GET
path: "/agents/me/deposits/{depositId}"
tags: ["Agent Operations"]
---

# Get an agent deposit

`GET /agents/me/deposits/{depositId}`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/agents/me/deposits/{depositId}`
- Auth: HTTP bearer

Retrieve a deposit created by the authenticated agent. Requires the RECEIVE_FUNDS permission in the agent's policy.

## Response `200`

Successful operation

- AgentDeposit: A deposit that converts funds from an external network into an internal account belonging to the agent's customer. A deposit reported `FAILED` or `EXPIRED` can still become `COMPLETED` when the funds arrive late; the platform then receives the `INCOMING_PAYMENT` webhook for the deposit's transaction again, now `COMPLETED`.
  - `id` string, required: System-generated unique deposit identifier.
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'EXPIRED' | 'FAILED' | 'REFUNDED', required: Current state of an agent deposit.
  - `sourceNetwork` 'LIGHTNING' | 'BASE' | 'ETHEREUM' | 'SOLANA' | 'POLYGON' | 'ARBITRUM' | 'TRON', required: Network from which an agent customer can fund a deposit. `TRON` deposits support `USDT` only.
  - `sourceCurrency` string, required: Currency or asset the customer sends.
  - `sourceAmount` integer: Amount to send in the smallest unit of `sourceCurrency`, when the deposit quote fixes the source amount.
  - `destinationInternalAccountId` string, required: Internal account that receives the converted deposit.
  - `destinationCurrency` string, required: Currency credited to the destination internal account.
  - `estimatedReceiveAmount` CurrencyAmount
    - `amount` integer, required: Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC)
    - `currency` Currency, required
      - `code` string: Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
      - `name` string: Full name of the currency
      - `symbol` string: Symbol of the currency
      - `decimals` integer: Number of decimal places for the currency
  - `targetType` 'LIGHTNING_INVOICE' | 'CHAIN_ADDRESS', required: Format of the payment target returned for an agent deposit.
  - `target` string, required: BOLT11 invoice when `targetType` is `LIGHTNING_INVOICE`; otherwise the address on `sourceNetwork` to which the customer sends funds.
  - `paymentLinks` object: Payment links for a `LIGHTNING` deposit. Absent for chain deposits.
    - `cashApp` string, uri, required: URL that opens the Lightning deposit in Cash App.
    - `shortUrl` string, uri: Shortened URL for the Lightning deposit, when available.
  - `expiresAt` string, date-time, nullable: Expiration time for a `LIGHTNING` invoice. Omitted or null for standing chain deposit addresses, which do not expire.
  - `createdAt` string, date-time, required: Time when the deposit was created.
  - `updatedAt` string, date-time, required: Time when the deposit was last updated.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Agents API is not enabled for the platform or the agent does not have the RECEIVE_FUNDS permission
- `404`: Deposit not found
- `500`: Internal service error

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-28** `d996ddfb9d2b`: 3 info
  - added the optional property `details/permission` to the response with the `403` status
  - added the optional property `details/policyDenialReason` to the response with the `403` status
  - added the optional property `details/refusalReason` to the response with the `403` status
- **2026-10-28** `5abf2bb56bcb`: 1 warning
  - added the new `CORRIDOR_UNDER_MAINTENANCE` enum value to the `code` response property for the response status `403`
- **2026-10-18** `add40cac0f84`: 1 warning
  - added the new `DESTINATION_NOT_ALLOWED` enum value to the `code` response property for the response status `403`
- **2026-10-18** `6d80d648535e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/agents/me/deposits/:depositId/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)