---
title: "Get specific cash deposit"
method: GET
path: "/ledger/cash-deposits/{reference}"
tags: ["ledger-cash deposits"]
---

# Get specific cash deposit

`GET /ledger/cash-deposits/{reference}`

Get specific cash deposit by reference

## Path parameters

- `reference` string, required

## Response `200`

cash deposit details

- CashDepositTransaction — Details of a cash deposit transaction.
  - `id` string, uuid, required
  - `reference` string, required — Reference for the cash deposit transaction at initiation.
  - `accountTransactionId` string — Identifier of the credit transaction on the account.
  - `currency` string, required — Currency in which the account was credited.
  - `status` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'SUCCESS', required — Status of the transaction, indicating its current state in the processing lifecycle. - PENDING: The transaction has been created but not yet processed. - IN_PROGRESS: The transaction is currently being processed. - FAILED: The transaction processing has failed. - SUCCESS: The transaction has been successfully processed.
  - `payinCurrency` string, required — Currency the customer paid in.
  - `amount` number, required — Amount credited to the account.
  - `rate` number, required — Exchange rate applied for this deposit.
  - `payinAmount` number, required — Amount the customer paid in, in the pay-in currency.
  - `providerReference` string — Reference provided by the cash deposit provider.
  - `paymentDetails` CashDepositPaymentDetails — Destination account details the customer must pay into to fund the deposit. Mirrors a Beneficiary (without an id). Carries only the account details needed to make the payment; transaction context (amount, status, etc.) lives on the enclosing CashDepositTransaction. `details` can be nullable when the account number provider is still generating it
    - `details` CashAccountDetails
      - `accountInfoType` string, required — Used to determine the exact schema type. Allowed values: - CashLocalBankAccount - CashSepaBankAccount - CashACHBankAccount - CashSwiftBankAccount - CashMobileWalletAccount - CashMultiRailBankAccount
      - `accountName` string, required — Name on the destination account.
      - `accountNumber` string, required — The destination account identifier. For mobile money this is the phone number, for P2P wallet the account ID. Where routing number or sort code is present, this would be `{routingNumber}-{accountNumber}`.
      - `reference` string — Reference the customer must include with the deposit so the pay-in is auto-matched. Optional — some providers do not require one.
    - `payinCurrency` string, required — Currency the destination account accepts for the deposit.
    - `paymentMethods` PaymentMethodCapability[] — Fee, limits, and settlement timeline per payment rail this account accepts deposits through, so a business can see up front what each rail will cost and how long it will take. Empty when the account-number provider has no capability data configured for this currency yet.
      - `rail` 'ACH' | 'FEDWIRE' | 'SWIFT' | 'SEPA' | 'FPS' | 'FPS_CROSS_SCHEME' | 'NIP', required — A payment rail an account-number provider can settle a deposit through.
      - `fee` PaymentMethodFee, required — The fee charged to the customer for a deposit made via this rail.
        - `percentage` number, required — Fee as a fraction of the deposit amount, e.g. 0.0035 = 0.35%.
        - `fixedAmount` number, required — Flat fee added on top of the percentage fee, in `currency`.
        - `currency` string, required — Currency `fixedAmount` is denominated in.
      - `limits` PaymentMethodLimits — Deposit amount limits for this rail, split by whether the sender is the account owner (first-party) or someone else (third-party) — third-party deposits are typically capped lower as an AML control.
        - `minAmount` number, required
        - `firstParty` PartyDepositLimits — Maximum deposit amount(s) for one party type (see PaymentMethodLimits). A null maxPerTransaction or maxPerDay means no limit is enforced for that period — e.g. NGN's first-party bank transfers have no cap at all, while third-party transfers are capped both per-transaction and per-day.
          - `maxPerTransaction` number
          - `maxPerDay` number
        - `thirdParty` PartyDepositLimits — Maximum deposit amount(s) for one party type (see PaymentMethodLimits). A null maxPerTransaction or maxPerDay means no limit is enforced for that period — e.g. NGN's first-party bank transfers have no cap at all, while third-party transfers are capped both per-transaction and per-day.
          - `maxPerTransaction` number
          - `maxPerDay` number
        - `currency` string, required
      - `timeline` PaymentMethodTimeline — How long a deposit made via this rail is expected to take to settle.
        - `minValue` integer, required
        - `maxValue` integer, required
        - `unit` 'MINUTES' | 'HOURS' | 'BUSINESS_DAYS', required
  - `createdDate` string, date-time, required

## Other responses

- `401` — Client is not authorized to make request
- `404` — Entity was not found

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/35fe01ca087b/schema)